README

• 自动运行 artisan 命令
• 调度在版本控制系统中维护
• 关于何时何地运行命令的单一真相来源
• 计划带有参数和选项的命令运行
• 以其他用户身份运行命令
• 在特定环境中运行命令
• 使用自定义驱动程序进行自定义调度上下文

在所有计划命令中...

scheduled:scheduled:make 创建一个新的计划中的 artisan 命令 scheduled:run 运行计划中的命令 scheduled:summary 查看所有计划中的 artisan 命令的摘要 

如果命令通过 php artisan 不可见，则无法进行计划。

你可以实现 \Indatus\Dispatcher\Scheduling\ScheduledCommandInterface 或遵循以下步骤。

1. 在你的命令中添加使用语句。如果你使用的是自定义驱动，你将使用不同的 Scheduler 类。

use Indatus\Dispatcher\Scheduling\ScheduledCommand;
use Indatus\Dispatcher\Scheduling\Schedulable;
use Indatus\Dispatcher\Drivers\DateTime\Scheduler;

1. 扩展 \Indatus\Dispatcher\Scheduling\ScheduledCommand
2. 实现 schedule()

	/**
	 * When a command should run
	 *
	 * @param Scheduler $scheduler
	 *
	 * @return Scheduler
	 */
	public function schedule(Schedulable $scheduler)
	{
		return $scheduler;
    }

您可以通过覆盖 user() 方法来以特定用户身份运行指定的 artisan 命令。请确保您的 scheduled:run artisan 命令以 root 用户身份运行。

 public function user() { return 'backup'; }

注意：此功能可能不是所有驱动器都支持。

您可以通过覆盖 environment() 方法来确保您的命令仅在特定的环境中被安排运行。它应该提供单个环境或一个环境数组。

 public function environment() { return ['development','staging']; }

默认情况下，当应用程序处于维护模式时，cron 命令将 不会 运行。这将防止在迁移数据库或执行 composer 更新时运行 cron 命令可能出现的各种奇怪输出。

您可以通过覆盖 runInMaintenanceMode() 方法来强制命令在应用程序处于维护模式时仍然运行。

 public function runInMaintenanceMode() { return true; }

您可以通过 schedule() 返回多个 Schedulable 实例来安排特定命令在多个时间运行。

 public function schedule(Schedulable $scheduler) { return [ // 5am Mon-Fri $scheduler->everyWeekday()->hours(5), // 2am every Saturday App::make(get_class($scheduler)) ->daysOfTheWeek(Scheduler::SATURDAY) ->hours(2) ]; }

您还可以安排带有参数和选项的命令运行。

 public function schedule(Schedulable $scheduler) { return [ // 等同于：php /path/to/artisan command:name /path/to/file $scheduler->args(['/path/to/file']) ->everyWeekday() ->hours(5), // 等同于：php /path/to/artisan command:name /path/to/file --force --toDelete="expired" --exclude="admins" --exclude="developers" $scheduler->args(['/path/to/file']) ->opts([ 'force', 'toDelete' => 'expired', 'exclude' => [ 'admins', 'developers' ] ]) ->daysOfTheMonth([1, 15]) ->hours(2) ]; }

注意：无论先调用哪个，args() 和 opts() 都将内部为您创建一个新的 Schedulable 实例，因此您不需要 App::make()。

如何安排的示例：

 public function schedule(Schedulable $scheduler) { //每天早上4:17 return $scheduler->daily()->hours(4)->minutes(17); }

 public function schedule(Schedulable $scheduler) { //每周二/周四早上5:03 return $scheduler->daysOfTheWeek([ Scheduler::TUESDAY, Scheduler::THURSDAY ])->hours(5)->minutes(3); }

 public function schedule(Schedulable $scheduler) { //每月第二和第三个星期二的午夜 return $scheduler->monthly()->week([2, 3])->daysOfTheWeek(Day::TUESDAY); }

自定义驱动程序允许你在安排中提供应用程序上下文。例如，一个基于教育的应用程序可能包含诸如inServiceDays()、springBreak()和christmasBreak()之类的安排方法，在这些时间内运行或停止运行命令。

创建一个包路径，例如\MyApp\ScheduleDriver\，然后创建两个类：

• Scheduler实现Indatus\Dispatcher\Scheduling\Schedulable。这个类应该为程序员提供一个有用的接口来安排他们的命令。
• ScheduleService扩展\Indatus\Dispatcher\Services\ScheduleService。这个类包含确定是否运行命令的逻辑。

使用php artisan config:publish indatus/dispatcher发布配置。然后更新你的驱动程序配置以引用包含这两个类的包（不要包含尾随斜杠）：

 'driver' => '\MyApp\ScheduleDriver'

我需要将部署到多个服务器，这些服务器代表单个环境。我如何确保我的命令只由一个服务器运行，而不是每个服务器都运行？