任务调度

简介

在过去，开发者必须为每个需要调度的任务生成单独的 Cron 项目。然而令人头疼的是任务调度不受版本控制，并且需要 SSH 到服务器上来增加 Cron 项目。Laravel 命令调度器允许你在 Laravel 中对命令调度进行清晰流畅的定义，并且仅需要在服务器上增加一条 Cron 项目即可。

你的调度已经定义在 app/Console/Kernel.php 文件的 schedule 方法中。为了方便你开始，在该方法内包含了一个简单的例子。你可以随意增加调度到 Schedule 对象中。

启动调度器

底下是唯一一个需要加入到服务器的 Cron 项目：

* * * * * php /path/to/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 = [
        \App\Console\Commands\Inspire::class,
    ];

    /**
     * 定义应用程序的命令调度。
     *
     * @param  \Illuminate\Console\Scheduling\Schedule  $schedule
     * @return void
     */
    protected function schedule(Schedule $schedule)
    {
        $schedule->call(function () {
            DB::table('recent_users')->delete();
        })->daily();
    }
}

除了计划 闭包 调用，你还能计划 Artisan 命令 以及系统命令操作。举个例子，你可以使用 command 方法计划一个 Artisan 命令：

$schedule->command('emails:send --force')->daily();

exec 命令可发送命令到操作系统上：

$schedule->exec('node /home/forge/script.js')->daily();

调度频率设置

当然，你可以针对你的任务来分配多种调度计划：

方法	描述
->cron('* * * * * *');	Run the task on a custom Cron schedule
->everyMinute();	Run the task every minute
->everyFiveMinutes();	Run the task every five minutes
->everyTenMinutes();	Run the task every ten minutes
->everyThirtyMinutes();	Run the task every thirty minutes
->hourly();	Run the task every hour
->daily();	Run the task every day at midnight
->dailyAt('13:00');	Run the task every day at 13:00
->twiceDaily(1, 13);	Run the task daily at 1:00 & 13:00
->weekly();	Run the task every week
->monthly();	Run the task every month
->monthlyOn(4, '15:00');	Run the task every month on the 4th at 15:00
->quarterly();	Run the task every quarter
->yearly();	Run the task every year
->timezone('America/New_York');	Set the timezone

这些方法可以合并其它限制条件以生成更精确的调度。例如在某周的某几天运行调度。举个例子，计划一个每周周一的调度：

// 每周一的下午一点钟运行
$schedule->call(function () {
    //
})->weekly()->mondays()->at('13:00');

// 工作日中从早上 8 点钟运行到下午 5 点
$schedule->command('foo')
          ->weekdays()
          ->hourly()
          ->timezone('America/Chicago')
          ->when(function () {
                return date('H') >= 8 && date('H') <= 17;
          });

下方列出其它额外限制条件：

方法	描述
->weekdays();	限制任务在工作日
->sundays();	限制任务在星期日
->mondays();	限制任务在星期一
->tuesdays();	限制任务在星期二
->wednesdays();	限制任务在星期三
->thursdays();	限制任务在星期四
->fridays();	限制任务在星期五
->saturdays();	限制任务在星期六
->when(Closure);	限制任务基于一个为真的验证

为真验证限制条件

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 方法时，计划命令只有在所有的 when 条件返回 true 时才运行。

避免任务重复

默认情况，即便之前相同的任务主体仍未结束，现有计划任务依旧会被运行。为了避免这个问题，你可以使用 withoutOverlapping 方法：

$schedule->command('emails:send')->withoutOverlapping();

在这个例子中，如果没有其它 emails:send Artisan 命令 在运行的话，此任务将于每分钟被运行一次。当你有些任务运行时间过长，且无法预测出具体所需时间时，withoutOverlapping 方法将会特别有帮助。

任务输出

Laravel 调度器为任务调度输出提供多种便捷方法。首先，通过 sendOutputTo 你可以发送输出到单个文件上以便后续检查：

$schedule->command('emails:send')
         ->daily()
         ->sendOutputTo($filePath);

如果想将输出附加到指定的文件上，则可以使用 appendOutputTo 方法：

$schedule->command('emails:send')
         ->daily()
         ->appendOutputTo($filePath);

通过 emailOutputTo 方法，你可以发送输出到你所指定的电子邮件上。注意，你必须先通过 sendOutputTo 方法将其输出到一个文件。同时，在邮件发出之前，你需要先设置 Laravel 的 电子邮件服务：

$schedule->command('foo')
         ->daily()
         ->sendOutputTo($filePath)
         ->emailOutputTo('foo@example.com');

注意

emailOutputTo 与 sendOutputTo 方法只适用于 command 方法，并且不支持 call 方法。

任务挂勾

通过 before 与 after 方法，你能让特定的代码在任务完成之前及之后运行：

$schedule->command('emails:send')
         ->daily()
         ->before(function () {
             // 任务将要开始...
         })
         ->after(function () {
             // 任务已完成...
         });

Ping 网址

通过 pingBefore 与 thenPing 方法，调度器能自动的在一个任务完成之前或之后 ping 一个指定的网址。该方法在你计划的任务进行或完成时，可用来有效的通知一个外部服务，例如 Laravel Envoyer：

$schedule->command('emails:send')
         ->daily()
         ->pingBefore($url)
         ->thenPing($url);

使用 pingBefore($url) 或 thenPing($url) 功能需要 Guzzle HTTP 函数库的支持。可在 composer.json 文件中加入以下代码来安装 Guzzle：

"guzzlehttp/guzzle": "~5.3|~6.0"

---

备注

欢迎任何形式的转载，但请务必注明出处，尊重他人劳动共创开源社区。

转载请注明：本文档由 Laravel China 社区 [laravel-china.org] 组织翻译。

文档永久地址： http://d.laravel-china.org