laravel 进阶系列 —— 定时任务调度在 Laravel 中的实现
简介
Cron 是 UNIX、SOLARIS、LINUX 下的一个十分有用的工具，通过 Cron 脚本能使计划任务定期地在系统后台自动运行。这种计划任务在 UNIX、SOLARIS、LINUX下术语为 Cron Jobs。Crontab 则是用来记录在特定时间运行的 Cron 的一个脚本文件，Crontab 文件的每一行均遵守特定的格式：
我们可以在服务器上通过 crontab -e 来新增或编辑 Cron 条目，通过 crontab -l 查看已存在的 Cron 条目。更多关于 Cron 的原理和使用细节请自行百度或 Google。
在以前，开发者需要为每一个需要调度的任务编写一个 Cron 条目，这是很让人头疼的事。你的任务调度不在源码控制中，你必须使用 SSH 登录到服务器然后添加这些 Cron 条目。
Laravel 命令调度器允许你流式而又不失优雅地在 Laravel 中定义命令调度，并且服务器上只需要一个 Cron 条目即可。任务调度定义在 app/Console/Kernel.php 文件的 schedule 方法中，该方法中已经包含了一个示例。
开启调度器
下面是你唯一需要添加到服务器的 Cron 条目，如果你不知道如何添加 Cron 条目到服务器，可以考虑使用诸如 Laravel Forge 这样的服务来为管理 Cron 条目：
* * * * * php /path-to-your-project/artisan schedule:run >> /dev/null 2>&1
该 Cron 将会每分钟调用一次 Laravel 命令调度器，然后，Laravel 评估你的调度任务并运行到期的任务。
定义调度
你可以在 App\Console\Kernel 类的 schedule 方法中定义所有调度任务。让我们从一个调度任务的例子开始，在这个例子中，我们将会在每天午夜调度一个被调用的闭包。在这个闭包中我们将会执行一个数据库操作来清空表：
<?php namespace App\Console; use DB; use Illuminate\Console\Scheduling\Schedule; use Illuminate\Foundation\Console\Kernel as ConsoleKernel; class Kernel extends ConsoleKernel{ /** * 应用提供的Artisan命令 * * @var array */ protected $commands = [ // ]; /** * 定义应用的命令调度 * * @param \Illuminate\Console\Scheduling\Schedule $schedule * @return void * @translator laravelacademy.org */ protected function schedule(Schedule $schedule) { $schedule->call(function () { DB::table('recent_users')->delete(); })->daily(); } }
调度 Artisan 命令
除了调度闭包调用外，还可以调度 Artisan 命令和操作系统命令。例如，可以使用 command 方法通过命令名或类来调度一个 Artisan 命令：
$schedule->command('emails:send --force')->daily(); $schedule->command(EmailsCommand::class, ['--force'])->daily();
调度队列任务
job 方法可用于调度一个队列任务，通过该方法可以很方便地调度任务而不必调用 call 方法手动创建闭包来推送任务到队列：
$schedule->job(new Heartbeat)->everyFiveMinutes();
调度 Shell 命令
exec 方法可用于调用操作系统命令：
$schedule->exec('node /home/forge/script.js')->daily();
调度常用选项当然，你可以分配多种调度到任务：
| 方法 | 描述 |
|---|---|
->cron('* * * * *'); |
在自定义Cron调度上运行任务 |
->everyMinute(); |
每分钟运行一次任务 |
->everyFiveMinutes(); |
每五分钟运行一次任务 |
->everyTenMinutes(); |
每十分钟运行一次任务 |
->everyFifteenMinutes(); |
每十五分钟运行一次任务 |
->everyThirtyMinutes(); |
每三十分钟运行一次任务 |
->hourly(); |
每小时运行一次任务 |
->hourlyAt(17); |
每小时第十七分钟运行一次任务 |
->daily(); |
每天凌晨零点运行任务 |
->dailyAt('13:00'); |
每天13:00运行任务 |
->twiceDaily(1, 13); |
每天1:00 & 13:00运行任务 |
->weekly(); |
每周运行一次任务 |
->monthly(); |
每月运行一次任务 |
->monthlyOn(4, '15:00'); |
每月4号15:00运行一次任务 |
->quarterly(); |
每个季度运行一次 |
->yearly(); |
每年运行一次 |
->timezone('America/New_York'); |
设置时区 |
这些方法可以和额外的约束一起联合起来创建一周特定时间运行的、更加细粒度的调度，例如，要在每周一调度一个命令：
$schedule->call(function () { // 每周星期一13:00运行一次... })->weekly()->mondays()->at('13:00'); // 工作日的上午8点到下午5点每小时运行... $schedule->command('foo') ->weekdays() ->hourly() ->timezone('America/Chicago') ->between('8:00', '17:00');
下面是额外的调度约束列表：
| 方法 | 描述 |
|---|---|
->weekdays(); |
只在工作日运行任务 |
->sundays(); |
每个星期天运行任务 |
->mondays(); |
每个星期一运行任务 |
->tuesdays(); |
每个星期二运行任务 |
->wednesdays(); |
每个星期三运行任务 |
->thursdays(); |
每个星期四运行任务 |
->fridays(); |
每个星期五运行任务 |
->saturdays(); |
每个星期六运行任务 |
->between($start, $end); |
基于特定时间段运行任务 |
->when(Closure); |
基于特定测试运行任务 |
介于时间的约束条件
between 方法用于限定一天中特定时间段的任务执行：
$schedule->command('reminders:send') ->hourly() ->between('7:00', '22:00');
类似地，unlessBetween 方法用于排除指定时间段任务的执行：
$schedule->command('reminders:send') ->hourly() ->unlessBetween('23:00', '4:00');
-
真理测试的约束条件
when 方法用于限制任务基于给定真理测试的结果执行。换句话说，如果给定闭包返回true，只要没有其它约束条件阻止任务运行，该任务就会执行：
$schedule->command('emails:send')->daily()->when(function () { return true; });
skip 方法和 when 相反，如果 skip 方法返回true，调度任务将不会执行：
$schedule->command('emails:send')->daily()->skip(function () { return true; });
使用 when 方法链的时候，调度命令将只会执行返回 true 的 when 方法。
避免任务重叠
默认情况下，即使前一个任务仍然在运行调度任务也会运行，要避免这样的情况，可使用 withoutOverlapping 方法：
$schedule->command('emails:send')->withoutOverlapping();
在本例中，Artisan 命令 emails:send 每分钟都会运行 —— 如果该命令没有在运行的话。如果你的任务在执行时经常大幅度的变化，那么 withoutOverlapping 方法就非常有用，你不必再去预测给定任务到底要消耗多长时间。如果需要的话，你可以指定"without overlapping"锁失效前的分钟数，默认情况下，这个锁会在 24 小时后失效：
$schedule->command('emails:send')->withoutOverlapping(10);
维护模式当 Laravel 处于维护模式时，调度任务不会运行，不过，如果你想要在维护模式期间强制运行任务，可以使用 evenInMaintenanceMode 方法：
$schedule->command('emails:send')->evenInMaintenanceMode();
任务输出
Laravel 调度器为处理调度任务输出提供了多个方便的方法。首先，使用sendOutputTo 方法，你可以发送输出到文件以便稍后检查：
$schedule->command('emails:send') ->daily() ->sendOutputTo($filePath);
如果你想要追加输出到给定文件，可以使用 appendOutputTo 方法：
$schedule->command('emails:send') ->daily() ->appendOutputTo($filePath);
使用 emailOutputTo 方法，你可以将输出通过邮件发送给接收人。使用邮件发送任务输出之前，需要配置 Laravel 的邮件服务：
$schedule->command('foo') ->daily() ->sendOutputTo($filePath) ->emailOutputTo('foo@example.com');
注：emailOutputTo、 sendOutputTo 和 appendOutputTo 方法只对 command 方法有效，不支持 call 方法。
任务钩子
使用 before 和 after 方法，你可以指定在调度任务完成之前和之后要执行的代码：
$schedule->command('emails:send') ->daily() ->before(function () { // 任务即将开始... }) ->after(function () { // 任务已经完成... });
Ping URL
使用 pingBefore 和 thenPing方法，调度器可以在任务完成之前和之后自动 ping 给定的 URL。该方法在通知外部服务时很有用，例如 Laravel Envoyer，在调度任务开始或完成的时候：
$schedule->command('emails:send') ->daily() ->pingBefore($url) ->thenPing($url);
使用 pingBefore($url) 或 thenPing($url) 特性需要安装 HTTP 库 Guzzle，可以使用 Composer 包管理器来安装 Guzzle 依赖到项目：
composer require guzzlehttp/guzzle遇到的问题点:
1.在linux系统上创建定时任务时,
* * * * * php /path-to-your-project/artisan schedule:run >> /dev/null 2>&1larvel不运行,可能是需要在php前面写全路径.
2.app/Console/Kernel.php
如果代码不执行,可能是由于名称没有对上.
