README

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

在所有计划命令中...

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

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

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

1. 在您的命令中添加 use 语句。如果您使用的是自定义驱动程序，则将使用不同的 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) { //每月第二个和第三个星期二午夜12点 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' 

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