Laravel任务调度的简单使用

创建任务

在命令行执行下面的命令生产自定义任务文件,比如说创建一个定时取消订单的任务OrderCancel

php artisan make:command OrderCancel

命令执行完后会生成app/Console/Commands/OrderCancel.php文件

编写任务

在上一步生成的文件中编写代码,signature变量为执行的命令,handle()方法中写具体的实现逻辑

<?php

namespace App\Console\Commands;

use Illuminate\Console\Command;

class OrderCancel extends Command
{
    /**
     * The name and signature of the console command.
     *
     * @var string
     */
    protected $signature = 'order:cancel';

    /**
     * The console command description.
     *
     * @var string
     */
    protected $description = '30分钟未付款取消订单';

    /**
     * Create a new command instance.
     *
     * @return void
     */
    public function __construct()
    {
        parent::__construct();
    }

    /**
     * Execute the console command.
     *
     * @return mixed
     * @throws
     */
    public function handle()
    {
        echo 'The order has been cancelled'.PHP_EOL;
        return true;
    }
}

启动调度器

执行单个任务

在命令行直接执行自定义的执行命令即可测试方法,例如

php artisan order:cancel

会在命令行输出The order has been cancelled

执行全部任务

app/Console/Kernel.phpschedule方法中添加需要执行的全部任务

$schedule->command('order:cancel')->everyMinute();

然后执行下面的命令即可

php artisan schedule:run

everyMinute()是任务调度的时间控制,更多用法可以参考 Laravel入坑指南(番外)——任务调度 - 咚..咚 - 博客园 (cnblogs.com)

注意事项:php artisan schedule:run这个命令下echo不会在控制台打印,可以使用laravel自带的Log记录

自动执行任务

linux系统的crontab中添加下面的任务,每秒执行一次

* * * * * php /path-to-your-project/artisan schedule:run >> /dev/null 2>&1

如果需要精确到毫秒级的定时任务,可以自己写shell脚本来执行任务调度

并行执行任务

如果有多个任务调度,一般是顺序执行的,也就是要等第一个任务执行完成第二个才会开始执行,如果要让任务并行执行的话,需要在schedule方法中调用runInBackground()方法,例如

$schedule->command('order:cancel')->everyMinute()->runInBackground();

任务重复处理

如果一个任务执行需要5秒时间,但是任务是每秒执行的,就会出现上一次任务还没执行完,同一个任务又开始了,为了避免这种情况,需要在schedule方法中调用withoutOverlapping()方法,例如

$schedule->command('order:cancel')->withoutOverlapping();      //锁默认24小时失效
$schedule->command('order:cancel')->withoutOverlapping(10);    //锁10分钟失效

在任务执行的时候会添加一个锁,在加锁状态下任务是不会执行的,知道任务执行完成。当然还可以使用外部的手段来加锁,比如文件锁flock,或者redis的setnx都可以

输出重定向

schedule方法中调用appendOutputTo()方法可以指定输出流的文件

$schedule->command('order:cancel')->appendOutputTo($filePath);

任务钩子

使用 beforeafter 方法,你可以指定在调度任务完成之前和之后要执行的代码

$schedule->command('order:cancel')
        ->daily()
         ->before(function () {
             // 任务即将开始...
         })
         ->after(function () {
             // 任务已经完成...
         });

参考文档

Laravel入坑指南(番外)——任务调度 - 咚..咚 - 博客园 (cnblogs.com)

任务调度 |《Laravel 5.5 中文文档 5.5》| Laravel China 社区 (learnku.com)

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容