php artisan make:command 名称
在
app/console
就会看到刚刚所有创建的文件(名称)修改:
protected $signature = '名字';
protected $description = '添加描述';
需要执行的逻辑写在
handle
方法中注册路由命令,在
app/Console/Kernel.php
里protected $commands
里写入:
Commands\名称::class
- 在
app/Console/Kernel.php
里schedule
方法内加上:
$schedule->command('名字')->daily(); //每天凌晨零点执行
- 要实现定时任务还得让程序自动执行,切换到项目根目录,在命令行(
linux
)输入:
echo '* * * * * php /path/to/artisan schedule:run >> /dev/null 2>&1' > cron.txt
命令行输入
php artisan schedule:run
即可执行任务将文件路径传给
crontab
:
命令行执行:crontab cron.txt
corntab -l (相当于自动运行schedule run命令)
corntab -r(关掉定时任务)
调度常用选项
当然,你可以分配多种调度到任务:
-> 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'); 设置时区
这些方法可以和额外的约束一起联合起来创建一周特定时间运行的更加细粒度的调度,例如,要在每周一调度一个命令:
$schedule->call(function () {
// 每周星期一13:00运行一次...
})->weekly()->mondays()->at('13:00');
// 在工作日早上8点到下午5点每小时运行一次…
$schedule->command('foo')
->weekdays()
->hourly()
->timezone('America/Chicago')
->between('8:00', '17:00');
下面是额外的调度约束列表:
-> weekdays(); 只在工作日运行任务
-> sundays(); 每个星期天运行任务
-> mondays(); 每个星期一运行任务
-> tuesdays(); 每个星期二运行任务
-> wednesdays(); 每个星期三运行任务
-> thursdays(); 每个星期四运行任务
-> fridays(); 每个星期五运行任务
-> saturdays(); 每个星期六运行任务
-> between($start, $end); 基于特定时间段运行任务
-> when(Closure); 基于特定测试运行任务
介于时间的约束条件:
between
方法用于限定一天中特定时间段的任务执行:
$schedule->command('reminders:send')
->hourly()
->between('7:00', '22:00');
类似地,unlessBetween
方法用于排除指定时间段任务的执行:
$schedule->command('reminders:send')
->hourly()
->unlessBetween('23:00', '4:00');
真理测试的约束条件
when
方法用于限制任务基于给定真理测试的结果执行。换句话说,如果给定闭包返回true
,只要没有其它约束条件阻止任务运行,该任务就会执行:
$schedule->command('emails:send')->daily()->when(function () {
return true;
});
skip
方法和when
相反,如果skip
方法返回true
,调度任务将不会执行:
$schedule->command('emails:send')->daily()->skip(function () {
return true;
});
使用when
方法链的时候,调度命令将只会执行返回true
的when
方法。
避免任务重叠
默认情况下,即使前一个任务仍然在运行调度任务也会运行,要避免这样的情况,可使用withoutOverlapping
方法:
$schedule->command('emails:send')->withoutOverlapping();
在本例中,Artisan
命令emails:send
每分钟都会运行,如果该命令没有在运行的话。如果你的任务在执行时经常大幅度的变化,那么withoutOverlapping
方法就非常有用,你不必再去预测给定任务到底要消耗多长时间。