Laravel通过内置调度器简化定时任务管理,只需配置系统级Cron每分钟执行php artisan schedule:run,所有任务在App\Console\Kernel.php的schedule方法中定义,支持dailyAt、everyFiveMinutes等链式调用设置周期,可结合sendOutputTo记录日志或onFailure发送错误通知,开发时可用schedule:run手动测试,实现统一、便捷的定时任务运维。

在 Laravel 中实现任务调度非常方便,Laravel 提供了内置的“命令调度器”,允许你通过代码定义定时任务(Cron Job),而不需要手动去服务器配置复杂的 Cron 条目。你可以把需要定期执行的任务,比如清理日志、发送邮件、同步数据等,统一在 Laravel 调度系统中管理。
1. 配置系统级 Cron
Laravel 的任务调度依赖于系统的一个单一的 Cron 条目。你需要在服务器上添加以下 Cron 任务,让它每分钟运行一次 Laravel 的调度检查命令:
* * * * * cd /path-to-your-project && php artisan schedule:run >> /dev/null 2>&1说明:这个命令会每分钟调用一次 schedule:run,Laravel 内部会判断当前是否有需要执行的任务。
2. 定义任务调度(App\Console\Kernel.php)
所有调度任务都在 app/Console/Kernel.php 文件中的 schedule 方法里定义。
例如:每天凌晨 2 点备份数据库,并每 5 分钟检查一次队列状态:
protected function schedule(Schedule $schedule)
{
// 每天凌晨 2 点执行数据库备份
$schedule->command('backup:run')->dailyAt('02:00');
// 每 5 分钟执行一次自定义命令
$schedule->command('queue:monitor')->everyFiveMinutes();
// 执行 PHP 闭包(比如清理临时文件)
$schedule->call(function () {
\Storage::disk('local')->deleteDirectory('/tmp');
})->daily();
}3. 常用调度频率方法
Laravel 提供了很多链式方法来设置执行周期:
- ->everyMinute():每分钟执行
- ->hourly():每小时执行
- ->daily():每天零点执行
- ->dailyAt('13:30'):每天指定时间执行
- ->weekly():每周执行(默认周一凌晨)
- ->monthly():每月第一天凌晨执行
- ->cron('* * * * *'):自定义 Cron 表达式
4. 任务输出与日志记录
建议将任务输出重定向到日志文件,便于排查问题:
```php $schedule->command('backup:run') ->dailyAt('02:00') ->sendOutputTo(storage_path('logs/backup.log')); ```也可以在出错时发送通知:
```php $schedule->command('some:task') ->daily() ->onFailure(function () { \Log::error('任务执行失败!'); }); ```5. 测试调度任务
在开发环境测试时,可以使用 Artisan 命令手动触发调度:
php artisan schedule:run它会检查所有定义的任务并运行那些到达执行时间的。
基本上就这些。只要配置好系统 Cron 并在 Kernel.php 中写好逻辑,Laravel 就能自动帮你管理所有定时任务,无需手动维护多个 shell 脚本或远程服务器 Cron 表达式。










