Laravel通过单一Cron入口触发调度器,自动执行app/Console/Kernel.php中定义的任务,如定时运行命令、脚本或闭包,并支持输出日志、条件控制和时间限制,简化了任务调度管理。

Laravel 的任务调度功能让你可以通过代码轻松管理定时任务,无需手动在服务器上配置复杂的 Cron 条件。你只需要在 Laravel 中定义调度逻辑,然后在服务器上添加一条 Cron 入口,框架会自动处理任务的运行时机。
1. 任务调度的基本原理
Laravel 使用 Artisan 命令和内置的调度器来管理定时任务。所有调度逻辑集中在 app/Console/Kernel.php 文件中的 schedule() 方法里。Laravel 会通过一个单一的 Cron 条目触发调度检查,再由框架判断哪些任务需要执行。
服务器只需设置一次系统级 Cron:
* * * * * cd /path-to-your-project && php artisan schedule:run >> /dev/null 2>&1这条命令每分钟运行一次 Laravel 调度器,由 Laravel 决定具体执行哪些任务。
2. 定义定时任务
打开 app/Console/Kernel.php 文件,在 schedule() 方法中添加你的任务。
常见任务示例:
- 每五分钟执行一次命令: $schedule->command('inspire')->everyFiveMinutes();
- 每天凌晨两点运行: $schedule->command('emails:send')->daily()->at('2:00');
- 每周一上午九点执行: $schedule->command('backup:run')->weekly()->mondays()->at('9:00');
- 每小时执行一次闭包任务(注意:闭包任务不能跨进程安全执行,建议封装成命令): $schedule->call(function () { \Log::info('每小时记录一次'); })->hourly();
- 执行系统脚本: $schedule->exec('node /home/script.js')->daily();
3. 设置任务输出与日志
你可以将命令的输出重定向到文件,便于调试或记录。
- 保存输出: $schedule->command('emails:send')->daily()->sendOutputTo('/storage/logs/email-sent.log');
- 追加并发送错误信息: $schedule->command('emails:send')->daily()->appendOutputTo('/storage/logs/mix.log');
4. 控制任务运行条件
使用 when() 方法可以添加运行条件,只有条件返回 true 才执行。
$schedule->command('emails:send')->daily()->when(function () { return ! app()->isLocal(); });上面的例子表示:只在非本地环境时发送邮件。
还可以限制任务在特定时间段运行:
$schedule->command('maintenance:enable')->daily()->between('23:00', '4:00');5. 测试调度任务
开发时想立即测试任务?可以手动运行:
php artisan schedule:run这会检查所有定义的任务,并执行当前应运行的那些。
查看即将运行的任务列表(Laravel 8+ 支持):
php artisan schedule:list基本上就这些。只要写好调度逻辑,部署时确保服务器的 Cron 正确指向 schedule:run,Laravel 就会帮你精准控制任务执行。










