laravel通过单一系统cron触发调度内核,所有任务在app/console/Kernel.php中定义,支持命令、闭包、脚本执行,可设置频率、环境、条件及防重叠,使用php artisan schedule:list查看和schedule:run测试,实现集中化、可维护的定时任务管理。

在Laravel中设置定时任务非常方便,Laravel自带了一个强大的任务调度器,允许你通过代码定义Crontab任务,而无需手动在服务器上配置多个cron条目。整个调度系统基于一个单一的服务器cron配置,所有任务由Laravel统一管理。
1. 配置系统Crontab
Laravel调度器依赖于系统级别的cron来触发调度内核。你需要在服务器上添加一条固定的cron条目:
* * * * * cd /path-to-your-project && php artisan schedule:run >> /dev/null 2>&1
这条命令每分钟执行一次Laravel的调度检查,由Laravel判断哪些任务需要运行。替换 /path-to-your-project 为你的项目根目录路径。
2. 定义调度任务(AppConsoleKernel.php)
所有定时任务都在 app/Console/Kernel.php 文件中的 schedule 方法里定义。
示例:每天凌晨1点执行某个命令
protected function schedule(Schedule $schedule) { $schedule->command('inspire')->dailyAt('01:00'); }
常见调度频率方法:
- ->everyMinute() – 每分钟
- ->hourly() – 每小时
- ->daily() – 每天零点
- ->dailyAt(’13:00′) – 每天13:00
- ->weekly() – 每周
- ->monthly() – 每月
- ->timezone(‘Asia/Shanghai’) – 设置时区
3. 执行闭包或自定义逻辑
除了Artisan命令,也可以直接调度php闭包:
$schedule->call(function () { // 清理缓存或处理数据 Cache::flush(); })->daily();
还可以调用脚本文件:
$schedule->exec('php /path/to/script.php')->hourly();
4. 设置运行环境和条件
你可以限制任务只在特定环境下运行:
$schedule->command('emails:send')->daily()->environments(['production']);
或者使用 when 添加运行条件:
$schedule->command('emails:send')->daily()->when(function () { return config('app.env') === 'production'; });
避免重叠执行(防止前一个任务未完成就启动下一个):
$schedule->command('emails:send')->daily()->withoutOverlapping();
5. 查看和测试调度任务
你可以使用以下命令查看即将运行的任务:
php artisan schedule:list
在开发环境中测试任务是否会被正确调度。
要手动运行所有待执行任务(用于调试):
php artisan schedule:run
基本上就这些。Laravel的调度器让Crontab管理变得集中、可版本控制且易于维护。只要确保服务器上那一条cron存在,其余全靠代码定义。不复杂但容易忽略。
以上就是Laravel定时任务怎么设置_Laravel Crontab调度器配置的详细内容,更多请关注php中文网其它相关文章!