定时调用 Artisan 命令

过去，开发者会对每个他们想要调用的命令行指令建立 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);