定时调用 Artisan 命令
最后更新于：2022-04-01 15:13:41
过去，开发者会对每个他们想要调用的命令行指令建立 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);
~~~