laravel 任务调度器
背景:
在实际工作业务中,经常要用到异步任务的方式来进行相关(耗时)任务的处理,这时可能需要采取定时任务的方式来进行。linux自带的crontab定时器工具能很好的解决这个问题。
每次项目上线的时候,如有新的异步任务脚本就必定要×××器管理员进行crontab配置修改。因为需要动服务器配置,沟通协调确认的过程都避免不了。
laravel自带的schedule任务调度能很好解决这个痛点。
laravel任务调度
php artisan schedule:run
实现步骤
1、crontab -e 增加定时执行laravel任务调度
#每分钟执行一次laravel任务调度,注意项目的绝对路径必须写正确。 * * * * * * php /site-path/artisan schedule:run >> /dev/null 2>&1
手动运行调度测试:
php artisan schedule:run
2、增加artisan Command命令行脚本文件
不做具体介绍,请参照官方文档
3、在Console内核中注册新建的命令行脚本文件信息
console内核文件/app/Console/Kernel.php
protected $commands = [ "App\\Console\\Commands\\MigrateCompanyDataCommand",//迁移代记账公司数据到对象表 "App\\Console\\Commands\\ReportCustomerSettleAccountEventCommand",//上报帐套结帐事件 "App\\Console\\Commands\\IndicatorComputeCommand",//指标计算 ];
4、配置调度信息
在调度配置中增加相关command任务的执行频率即可完成定时任务部署。
protected function schedule(Schedule $schedule) { $schedule->command('command任务文件signature')->hourly(); }
5、关于执行频率
参照:Illuminate\Console\Scheduling\ManagesFrequencies
调度常用选项 ->cron(‘* * * * *’);在自定义Cron调度上运行任务 ->everyMinute();每分钟运行一次任务 ->everyFiveMinutes();每五分钟运行一次任务 ->everyTenMinutes();每十分钟运行一次任务 ->everyThirtyMinutes();每三十分钟运行一次任务 ->hourly();每小时运行一次任务 ->daily();每天凌晨零点运行任务 ->dailyAt(‘13:00’);每天13:00运行任务 ->twiceDaily(1, 13);每天1:00 & 13:00运行任务 ->weekly();每周运行一次任务 ->monthly();每月运行一次任务 ->monthlyOn(4, ‘15:00’);每月4号15:00运行一次任务 ->quarterly();每个季度运行一次 ->yearly();每年运行一次 ->timezone(‘America/New_York’);设置时区 ->weekdays();只在工作日运行任务 ->sundays();每个星期天运行任务 ->mondays();每个星期一运行任务 ->tuesdays();每个星期二运行任务 ->wednesdays();每个星期三运行任务 ->thursdays();每个星期四运行任务 ->fridays();每个星期五运行任务 ->saturdays();每个星期六运行任务 ->between($start, $end);基于特定时间段运行任务 ->when(Closure);基于特定测试运行任务
方法 | 描述 |
---|---|
->cron('* * * * *'); |
自定义 Cron 计划执行任务 |
->everyMinute(); |
每分钟执行一次任务 |
->everyTwoMinutes(); |
每两分钟执行一次任务 |
->everyThreeMinutes(); |
每三分钟执行一次任务 |
->everyFourMinutes(); |
每四分钟执行一次任务 |
->everyFiveMinutes(); |
每五分钟执行一次任务 |
->everyTenMinutes(); |
每十分钟执行一次任务 |
->everyFifteenMinutes(); |
每十五分钟执行一次任务 |
->everyThirtyMinutes(); |
每三十分钟执行一次任务 |
->hourly(); |
每小时执行一次任务 |
->hourlyAt(17); |
每小时第 17 分钟执行一次任务 |
->everyTwoHours(); |
每两小时执行一次任务 |
->everyThreeHours(); |
每三小时执行一次任务 |
->everyFourHours(); |
每四小时执行一次任务 |
->everySixHours(); |
每六小时执行一次任务 |
->daily(); |
每天 0 点执行一次任务 |
->dailyAt('13:00'); |
每天 13:00 执行一次任务 |
->twiceDaily(1, 13); |
每天 01:00 和 13:00 各执行一次任务 |
->weekly(); |
每周日 00:00 执行一次任务 |
->weeklyOn(1, '8:00'); |
每周一的 08:00 执行一次任务 |
->monthly(); |
每月第一天 00:00 执行一次任务 |
->monthlyOn(4, '15:00'); |
每月 4 号的 15:00 执行一次任务 |
->lastDayOfMonth('15:00'); |
每月最后一天 15:00 执行一次任务 |
->quarterly(); |
每季度第一天 00:00 执行一次任务 |
->yearly(); |
每年第一天 00:00 执行一次任务 |
->timezone('America/New_York'); |
设置时区 |
方法 | 描述 |
---|---|
->weekdays(); |
限制任务在工作日执行 |
->weekends(); |
限制任务在周末执行 |
->sundays(); |
限制任务在周日执行 |
->mondays(); |
限制任务在周一执行 |
->tuesdays(); |
限制任务在周二执行 |
->wednesdays(); |
限制任务在周三执行 |
->thursdays(); |
限制任务在周四执行 |
->fridays(); |
限制任务在周五执行 |
->saturdays(); |
限制任务在周六执行 |
->days(array|mixed); |
限制任务在每周的指定日期执行 |
->between($start, $end); |
限制任务在 $start 和 $end 区间执行 |
->when(Closure); |
限制任务在闭包返回为真时执行 |
->environments($env); |
限制任务在特定环境中执行 |
https://blog.51cto.com/phpme/2400997
任务调度 |《Laravel 8 中文文档 8.x》| Laravel China 社区
https://learnku.com/docs/laravel/8.x/scheduling/9399