Laravel任务调度通过app/Console/Kernel.php中的schedule方法定义任务，支持Artisan命令、闭包、系统命令和队列任务，结合Crontab每分钟运行schedule:run来触发，可设置daily、hourly等频率及复杂规则如weeklyOn、withoutOverlapping，并可通过日志、onOneServer、ping监控等方式调试和优化。
Laravel 任务调度，简单来说，就是让你像设置闹钟一样，定时执行一些 PHP 代码。至于调度命令，那得看你想怎么个“定时”法了。
使用 Laravel 的任务调度器，你可以将原本需要在服务器上手动运行的脚本，或者需要通过 Crontab 设置的定时任务，统一管理起来，方便维护和查看。
解决方案
Laravel 的任务调度核心在于
app/Console/Kernel.php文件。在这个文件的
schedule方法里，你可以定义你的调度任务。
基本步骤：
定义任务： 首先，你需要确定你要执行什么任务。这可以是一个 Artisan 命令，也可以是一个闭包函数，甚至是一个操作系统命令。
注册任务： 在
schedule
方法中，使用$schedule
对象注册你的任务，并指定执行频率。配置 Crontab： 最后，你需要配置服务器的 Crontab，让 Laravel 的调度器能够定期运行。
举个例子：
假设你要每天凌晨 1 点执行一个名为
backup:database的 Artisan 命令，你可以这样写：
// app/Console/Kernel.php
protected function schedule(Schedule $schedule)
{
$schedule->command('backup:database')
->dailyAt('01:00');
}这行代码的意思是，每天凌晨 1 点，执行
php artisan backup:database命令。
常用的调度方法：
daily()
: 每天执行hourly()
: 每小时执行weekly()
: 每周执行monthly()
: 每月执行cron($expression)
: 使用 Crontab 表达式自定义执行频率，比如cron('0 0 * * *')表示每天凌晨 0 点执行。everyMinute()
: 每分钟执行 (不推荐，除非有特殊需求)
别忘了在服务器上配置 Crontab，添加以下条目：
* * * * * php /path/to/your/project/artisan schedule:run >> /dev/null 2>&1
这个 Crontab 条目表示每分钟运行一次
php artisan schedule:run命令，Laravel 会检查是否有需要执行的任务，并执行它们。
副标题1
Laravel 任务调度支持哪些复杂的调度规则？
除了常见的
daily、
hourly之外，Laravel 调度器还支持更复杂的调度规则。例如：
-
指定星期/日期： 你可以使用
weeklyOn()
、monthlyOn()
方法指定任务在每周/每月的哪一天执行。$schedule->command('emails:send') ->weeklyOn(1, '13:00'); // 每周一 13:00 执行 -
执行环境判断： 你可以使用
environments()
方法指定任务只在特定的环境下执行，比如只在生产环境执行。$schedule->command('emails:send') ->daily() ->environments('production'); -
防止任务重叠： 如果你的任务执行时间比较长，可以使用
withoutOverlapping()
方法防止任务重叠执行。$schedule->command('emails:send') ->daily() ->withoutOverlapping();还可以指定锁的过期时间：
$schedule->command('emails:send') ->daily() ->withoutOverlapping(3600); // 锁 3600 秒 -
维护模式下的执行： 你可以使用
evenInMaintenanceMode()
方法让任务在维护模式下也能执行。这个通常用于一些必须在维护期间运行的任务，比如数据库迁移。$schedule->command('emails:send') ->daily() ->evenInMaintenanceMode();
副标题2
如何调试 Laravel 任务调度？如果任务没有按时执行怎么办？
调试任务调度，是个让人头疼的问题。首先，检查你的 Crontab 是否配置正确。你可以尝试手动运行
php artisan schedule:run命令，看看是否有任务被执行。
如果任务没有按时执行，可以尝试以下方法：
-
检查日志： Laravel 默认会将调度任务的输出写入日志文件。检查
storage/logs/laravel.log
文件，看看是否有错误信息。你也可以在调度任务中使用sendOutputTo()
方法将输出写入到指定的文件。$schedule->command('emails:send') ->daily() ->sendOutputTo('/path/to/output.log'); -
使用
thenPing()
方法： 你可以使用thenPing()
方法在任务执行完成后发送一个 HTTP 请求到指定的 URL，用于监控任务的执行情况。$schedule->command('emails:send') ->daily() ->thenPing('https://example.com/ping'); 检查服务器时区： 确保服务器的时区设置正确。Laravel 默认使用
config/app.php
文件中timezone
配置项指定的时区。-
检查任务是否被禁用： 你可以使用
when()
方法根据条件判断是否执行任务。检查你的条件是否正确。$schedule->command('emails:send') ->daily() ->when(function () { return true; // 总是执行 }); -
使用
onOneServer()
方法： 如果你在多台服务器上运行 Laravel 应用，可以使用onOneServer()
方法确保任务只在一台服务器上执行。$schedule->command('emails:send') ->daily() ->onOneServer();
副标题3
除了 Artisan 命令，Laravel 任务调度还能执行哪些类型的任务？
除了 Artisan 命令，Laravel 任务调度还可以执行以下类型的任务：
-
闭包函数： 你可以直接在
schedule
方法中定义一个闭包函数来执行任务。$schedule->call(function () { DB::table('users')->delete(); })->daily(); -
操作系统命令： 你可以使用
exec()
方法执行操作系统命令。$schedule->exec('node /path/to/script.js') ->daily();注意：执行操作系统命令需要谨慎，确保命令的安全性。
-
队列任务： 你可以使用
job()
方法将任务推送到队列中执行。$schedule->job(new ProcessPodcast)->daily();
-
调用外部 URL： 你可以使用
pingBefore()
和thenPing()
方法在任务执行前后调用外部 URL，用于监控任务的执行情况。$schedule->command('emails:send') ->daily() ->pingBefore('https://example.com/ping-before') ->thenPing('https://example.com/ping-after');
