文章详情

短信预约-IT技能 免费直播动态提醒

请输入下面的图形验证码

提交验证

短信预约提醒成功

laravel 进阶系列 —— 定时任务调度在 Laravel 中的实现

2023-09-22 18:07

关注

简介

Cron 是 UNIX、SOLARIS、LINUX 下的一个十分有用的工具,通过 Cron 脚本能使计划任务定期地在系统后台自动运行。这种计划任务在 UNIX、SOLARIS、LINUX下术语为 Cron Jobs。Crontab 则是用来记录在特定时间运行的 Cron 的一个脚本文件,Crontab 文件的每一行均遵守特定的格式:

我们可以在服务器上通过 crontab -e 来新增或编辑 Cron 条目,通过 crontab -l 查看已存在的 Cron 条目。更多关于 Cron 的原理和使用细节请自行百度或 Google。

在以前,开发者需要为每一个需要调度的任务编写一个 Cron 条目,这是很让人头疼的事。你的任务调度不在源码控制中,你必须使用 SSH 登录到服务器然后添加这些 Cron 条目。

Laravel 命令调度器允许你流式而又不失优雅地在 Laravel 中定义命令调度,并且服务器上只需要一个 Cron 条目即可。任务调度定义在 app/Console/Kernel.php 文件的 schedule 方法中,该方法中已经包含了一个示例。

开启调度器

下面是你唯一需要添加到服务器的 Cron 条目,如果你不知道如何添加 Cron 条目到服务器,可以考虑使用诸如 Laravel Forge 这样的服务来为管理 Cron 条目:

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

该 Cron 将会每分钟调用一次 Laravel 命令调度器,然后,Laravel 评估你的调度任务并运行到期的任务。

定义调度

你可以在 App\Console\Kernel 类的 schedule 方法中定义所有调度任务。让我们从一个调度任务的例子开始,在这个例子中,我们将会在每天午夜调度一个被调用的闭包。在这个闭包中我们将会执行一个数据库操作来清空表:

call(function () {            DB::table('recent_users')->delete();        })->daily();    }}

调度 Artisan 命令

除了调度闭包调用外,还可以调度 Artisan 命令和操作系统命令。例如,可以使用 command 方法通过命令名或类来调度一个 Artisan 命令:

$schedule->command('emails:send --force')->daily();$schedule->command(EmailsCommand::class, ['--force'])->daily();

调度队列任务

job 方法可用于调度一个队列任务,通过该方法可以很方便地调度任务而不必调用 call 方法手动创建闭包来推送任务到队列:

$schedule->job(new Heartbeat)->everyFiveMinutes();

调度 Shell 命令

exec 方法可用于调用操作系统命令:

$schedule->exec('node /home/forge/script.js')->daily();
调度常用选项

当然,你可以分配多种调度到任务:

方法描述
->cron('* * * * *');在自定义Cron调度上运行任务
->everyMinute();每分钟运行一次任务
->everyFiveMinutes();每五分钟运行一次任务
->everyTenMinutes();每十分钟运行一次任务
->everyFifteenMinutes();每十五分钟运行一次任务
->everyThirtyMinutes();每三十分钟运行一次任务
->hourly();每小时运行一次任务
->hourlyAt(17);每小时第十七分钟运行一次任务
->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');
  1. 真理测试的约束条件

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 方法就非常有用,你不必再去预测给定任务到底要消耗多长时间。

如果需要的话,你可以指定"without overlapping"锁失效前的分钟数,默认情况下,这个锁会在 24 小时后失效:

$schedule->command('emails:send')->withoutOverlapping(10);
维护模式

当 Laravel 处于维护模式时,调度任务不会运行,不过,如果你想要在维护模式期间强制运行任务,可以使用 evenInMaintenanceMode 方法:

$schedule->command('emails:send')->evenInMaintenanceMode();

任务输出

Laravel 调度器为处理调度任务输出提供了多个方便的方法。首先,使用sendOutputTo 方法,你可以发送输出到文件以便稍后检查:

$schedule->command('emails:send')     ->daily()     ->sendOutputTo($filePath);

如果你想要追加输出到给定文件,可以使用 appendOutputTo 方法:

$schedule->command('emails:send')     ->daily()     ->appendOutputTo($filePath);

使用 emailOutputTo 方法,你可以将输出通过邮件发送给接收人。使用邮件发送任务输出之前,需要配置 Laravel 的邮件服务

$schedule->command('foo')     ->daily()     ->sendOutputTo($filePath)     ->emailOutputTo('foo@example.com');

注:emailOutputTo、 sendOutputTo 和 appendOutputTo 方法只对 command 方法有效,不支持 call 方法。

任务钩子

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

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

Ping URL

使用 pingBefore 和 thenPing方法,调度器可以在任务完成之前和之后自动 ping 给定的 URL。该方法在通知外部服务时很有用,例如 Laravel Envoyer,在调度任务开始或完成的时候:

$schedule->command('emails:send')     ->daily()     ->pingBefore($url)     ->thenPing($url);

使用 pingBefore($url) 或 thenPing($url) 特性需要安装 HTTP 库 Guzzle,可以使用 Composer 包管理器来安装 Guzzle 依赖到项目: 

composerrequire guzzlehttp/guzzle

 遇到的问题点: 

在linux系统上创建定时任务时,

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

larvel不运行,可能是需要在php前面写全路径.

app/Console/Kernel.php

如果代码不执行,可能是由于名称没有对上.

来源地址:https://blog.csdn.net/zl_j_c/article/details/128612374

阅读原文内容投诉

免责声明:

① 本站未注明“稿件来源”的信息均来自网络整理。其文字、图片和音视频稿件的所属权归原作者所有。本站收集整理出于非商业性的教育和科研之目的,并不意味着本站赞同其观点或证实其内容的真实性。仅作为临时的测试数据,供内部测试之用。本站并未授权任何人以任何方式主动获取本站任何信息。

② 本站未注明“稿件来源”的临时测试数据将在测试完成后最终做删除处理。有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341

软考中级精品资料免费领

  • 历年真题答案解析
  • 备考技巧名师总结
  • 高频考点精准押题
  • 2024年上半年信息系统项目管理师第二批次真题及答案解析(完整版)

    难度     813人已做
    查看
  • 【考后总结】2024年5月26日信息系统项目管理师第2批次考情分析

    难度     354人已做
    查看
  • 【考后总结】2024年5月25日信息系统项目管理师第1批次考情分析

    难度     318人已做
    查看
  • 2024年上半年软考高项第一、二批次真题考点汇总(完整版)

    难度     435人已做
    查看
  • 2024年上半年系统架构设计师考试综合知识真题

    难度     224人已做
    查看

相关文章

发现更多好内容

猜你喜欢

AI推送时光机
位置:首页-资讯-后端开发
咦!没有更多了?去看看其它编程学习网 内容吧
首页课程
资料下载
问答资讯