过去，开发者会对每个他们想要调用的命令行指令建立 Cron 对象。然而，这很令人头痛。你的命令行指令调用不再包含在版本控制里面，并且你必须 SSH 进入你的服务器以添加 Cron 对象。让我们来让生活变得更轻松。Laravel 命令调用器允许你顺畅地且语义化地定义命令调用在 Laravel 里面，而且你的服务器只需要一个 Cron 对象。 你的命令调用保存在 `app/Console/Kernel.php` 文件。你会在这个类里看到一个 `schedule` 方法。为了帮助您开始，方法里面包含一个简单的例子。你可以依照你需要的自由地添加任何数量的预定工作到 `Schedule` 对象。你只需要添加这个 Cron 对象到服务器： ~~~ ~~~ * * * * * php /path/to/artisan schedule:run 1>> /dev/null 2>&1 ~~~ ~~~ 这个 Cron 将会每分钟调用 Laravel 命令调用器。接着，Laravel 评估你的预定工作并在时间到时执行工作。这不能再更简单了！ ### 更多调用的例子 让我们来多看几个调用的例子： ### 调用闭包 ~~~ ~~~ $schedule->call(function() { // 执行一些任务... })->hourly(); ~~~ ~~~ ### 调用终端机命令 ~~~ ~~~ $schedule->exec('composer self-update')->daily(); ~~~ ~~~ ### 自己配置 Cron 表达式 ~~~ ~~~ $schedule->command('foo')->cron('* * * * *'); ~~~ ~~~ ### 频繁的工作 ~~~ ~~~ $schedule->command('foo')->everyFiveMinutes(); $schedule->command('foo')->everyTenMinutes(); $schedule->command('foo')->everyThirtyMinutes(); ~~~ ~~~ ### 每天一次的工作 ~~~ ~~~ $schedule->command('foo')->daily(); ~~~ ~~~ ### 每天一次在特定时间 (24 小时制) 的工作 ~~~ ~~~ $schedule->command('foo')->dailyAt('15:00'); ~~~ ~~~ ### 每天两次的工作 ~~~ ~~~ $schedule->command('foo')->twiceDaily(); ~~~ ~~~ ### 每个工作日执行的工作 ~~~ ~~~ $schedule->command('foo')->weekdays(); ~~~ ~~~ ### 每周一次的工作 ~~~ ~~~ $schedule->command('foo')->weekly(); // 调用每周一次在特定的日子 (0-6) 和时间的工作... $schedule->command('foo')->weeklyOn(1, '8:00'); ~~~ ~~~ ### 每月一次的工作 ~~~ ~~~ $schedule->command('foo')->monthly(); ~~~ ~~~ ### 特定日期的工作 ~~~ ~~~ $schedule->command('foo')->mondays(); $schedule->command('foo')->tuesdays(); $schedule->command('foo')->wednesdays(); $schedule->command('foo')->thursdays(); $schedule->command('foo')->fridays(); $schedule->command('foo')->saturdays(); $schedule->command('foo')->sundays(); ~~~ ~~~ ### Prevent Jobs From Overlapping By default, scheduled jobs will be run even if the previous instance of the job is still running. To prevent this, you may use the `withoutOverlapping` method: ~~~ ~~~ $schedule->command('foo')->withoutOverlapping(); ~~~ ~~~ In this example, the `foo` command will be run every minute if it is not already running. ### 限制应该执行工作的环境 ~~~ ~~~ $schedule->command('foo')->monthly()->environments('production'); ~~~ ~~~ 指定工作在当应用程序处于维护模式也应该执行 ~~~ ~~~ $schedule->command('foo')->monthly()->evenInMaintenanceMode(); ~~~ ~~~ ### 只允许工作在闭包返回 true 的时候执行 ~~~ ~~~ $schedule->command('foo')->monthly()->when(function() { return true; }); ~~~ ~~~ ### 将预定工作的输出发送到指定的 E-mail ~~~ ~~~ $schedule->command('foo')->sendOutputTo($filePath)->emailOutputTo('foo@example.com'); ~~~ ~~~ > 注意: 你必须先把输出存到文件中才可以发送 email。 ### 将预定工作的输出发送到指定的路径 ~~~ ~~~ $schedule->command('foo')->sendOutputTo($filePath); ~~~ ~~~ ### 在预定工作执行之后 Ping 一个给定的 URL ~~~ ~~~ $schedule->command('foo')->thenPing($url); ~~~ ~~~