README

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

在所有计划命令中...

scheduled:scheduled:make 创建一个新的定时 artisan 命令 scheduled:scheduled:run 运行定时命令 scheduled: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 [ // 周一至周五的凌晨5点 $scheduler->everyWeekday()->hours(5), // 每周六凌晨2点 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' 

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