PHP Laravel 队列技巧：Fail、Retry 或者 Delay

最新推荐文章于 2025-06-06 07:00:00 发布

原创

最新推荐文章于 2025-06-06 07:00:00 发布 · 1.8k 阅读

1 ·

CC 4.0 BY-SA版权

文章标签：

#PHP #Laravel

这篇博客介绍了在 Laravel 中处理队列作业的技巧，包括检查尝试次数、删除队列作业、处理失败的作业以及延迟作业。通过`InteractsWithQueue`trait，开发者可以更好地控制队列作业的行为，例如在转码任务中根据需要进行重试、删除或延迟处理。此外，还讨论了如何在特定条件下避免处理作业并利用`failed()`方法执行清理操作。

当创建队列jobs、监听器或订阅服务器以推送到队列中时，您可能会开始认为，一旦分派，队列工作器决定如何处理您的逻辑就完全由您自己决定了。

嗯……并不是说你不能从作业内部与队列工作器交互，但是通常情况下，哪怕你做了，也是没必要的。

这个神奇的骚操作的出现是因为“InteractsWithQueue”这个trait。.当排队作业正在从队列中拉出, 这个 [CallQueuedListener](https://github.com/laravel/framework/blob/5.8/src/Illuminate/Events/CallQueuedListener.php#L90-L104) 会检查它是否在使用 InteractsWithQueue trait, 如果是的话，框架会将底层的“队列jobs”实例注入到内部。

这个 “任务” 实例类似于一个包装了真正的 Job 类的驱动，其中包含队列连接和尝试等信息。

背景

我将以一个转码 Job 为例。这是一个将广播音频文件转换成192kbps MP3格式的任务。因为这是在自由转码队列中设置的，所以它的作用有限。大型项目实战直播加入（点击→）我的直播群677079770

检查尝试次数

attempts()是被调用的第一个方法, 顾名思义，它返回尝试次数,一个队列 job总是伴随着一个attempt启动。

此方法旨在与其他方法一起使用 ..., 类似 fail() 或者 release() (delay). 为了便于说明，我们将通知用户第几次重试: 每次我们尝试在空闲队列中转换（转换代码）时，我们都会通知用户我们正在第几次重试，让他可以选择取消将来的转换（转换代码）。

<?php
namespace App\Jobs;
use App\Podcast;
use Transcoder\Transcoder;
use Illuminate\Bus\Queueable;
use Illuminate\Queue\SerializesModels;
use App\Notifications\PodcastTranscoded;
use Illuminate\Queue\InteractsWithQueue;
use Illuminate\Foundation\Bus\Dispatchable;
use App\Notifications\RetyingPodcastTranscode;
class TranscodePodcast
{
    use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;
    /**
     * Transcoder Instance
     *
     * @var \App\Podcast
     */
    protected $podcast;
    /**
     * 创建一个新的转码podcast实例。
     *
     * @param \App\Podcast $podcast
     * @return void
     */
    public function __construct(Podcast $podcast)
    {
        $this->podcast = $podcast;
    }
    /**
     * 执行队列job.
     *
     * @param \Transcoder\Transcoder $podcast
     * @return void
     */
    public function handle(Transcoder $transcoder)
    {
        // 告诉用户我们第几次重试
        if ($this->attempts() > 1) {
            $this->podcast->publisher->notify(new Re