Laravel任务调度只需配置一条每分钟执行的Cron,框架自动运行app/Console/Kernel.php中定义的任务,支持闭包、命令、脚本等多种类型,提供丰富的频率方法和日志记录功能,并可限制环境运行,简化定时任务管理。

Laravel 提供了强大的任务调度功能,让你可以通过 Artisan 命令轻松管理定时任务。你不再需要手动在服务器上配置多个 Cron 条目,只需要添加一条 Cron 记录指向 Laravel 的调度命令,框架会自动处理所有定义的任务。
1. 服务器上配置基础 Cron
要启用 Laravel 的任务调度,首先需要在你的服务器上设置一个 Cron 条目,让它每分钟运行一次 Laravel 的调度进程。
执行以下命令编辑服务器的 crontab:
* * * * * cd /path-to-your-project && php artisan schedule:run >> /dev/null 2>&1其中 /path-to-your-project 是你的 Laravel 项目根目录。这条命令会每分钟检查是否有需要执行的计划任务。
2. 定义计划任务(Schedule)
Laravel 的任务调度定义在 app/Console/Kernel.php 文件中的 schedule 方法里。
你可以在这里注册各种类型的定时任务,例如闭包、Artisan 命令、系统命令等。
示例:每天凌晨 2 点备份数据库
protected function schedule(Schedule $schedule) { $schedule->command('backup:run')->daily()->at('02:00'); }示例:每 5 分钟执行一次自定义任务
$schedule->call(function () { // 执行某些逻辑,比如清理缓存、同步数据等 })->everyFiveMinutes();示例:执行系统脚本
$schedule->exec('/usr/local/bin/cleanup.sh')->daily();3. 常用调度频率方法
Laravel 提供了很多链式方法来定义任务执行周期:
- ->everyMinute():每分钟执行
- ->everyFiveMinutes():每 5 分钟
- ->everyTenMinutes():每 10 分钟
- ->hourly():每小时
- ->daily():每天零点
- ->dailyAt('14:30'):每天指定时间
- ->weekly():每周一凌晨
- ->monthly():每月第一天
- ->timezone('Asia/Shanghai'):设置时区
也可以使用 Cron 表达式自定义周期:
$schedule->command('inspire')->cron('0 0 * * *');4. 任务输出与日志记录
你可以将任务的输出重定向到文件,便于调试和监控。
$schedule->command('emails:send')->daily()->output('/storage/logs/email.log');使用 append() 可追加内容而不覆盖:
$schedule->command('emails:send')->daily()->appendOutputTo('/storage/logs/email.log');如果想禁止输出,可使用 sendOutputTo 并指向 /dev/null。
5. 任务环境限制
可以限制任务只在特定环境下运行:
$schedule->command('emails:send')->daily()->onEnvironment('production');或使用 when 方法添加条件判断:
基本上就这些。只要配置好系统 Cron 并在 Kernel.php 中定义任务,Laravel 调度器就能自动运行,简洁又可靠。










