PHPackages                             jorisnoo/craft-queue-failure-handler - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Queues & Workers](/categories/queues)
4. /
5. jorisnoo/craft-queue-failure-handler

ActiveLibrary[Queues & Workers](/categories/queues)

jorisnoo/craft-queue-failure-handler
====================================

Release matching queue jobs after they fail, instead of leaving them in the failed-jobs list. Pairs with webhubworks/craft-flare for reporting.

0.1.0(4w ago)012↓50%MITPHPPHP ^8.2CI passing

Since May 12Pushed 4w agoCompare

[ Source](https://github.com/jorisnoo/craft-queue-failure-handler)[ Packagist](https://packagist.org/packages/jorisnoo/craft-queue-failure-handler)[ Docs](https://github.com/jorisnoo/craft-queue-failure-handler)[ RSS](/packages/jorisnoo-craft-queue-failure-handler/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (1)Dependencies (1)Versions (2)Used By (0)

Craft Queue Failure Handler
===========================

[](#craft-queue-failure-handler)

A small Craft CMS module that releases matching queue jobs after they fail, instead of leaving them in the failed-jobs list. Pairs with [`webhubworks/craft-flare`](https://github.com/webhubworks/craft-flare) so failures are still reported, just not stuck in the queue.

Useful for queue jobs that won't recover on retry — revoked API credentials, deleted remote resources, deactivated accounts, malformed external state.

Requirements
------------

[](#requirements)

- PHP 8.2+
- Craft CMS 5
- (Optional but recommended) `webhubworks/craft-flare` for error reporting

Installation
------------

[](#installation)

```
composer require jorisnoo/craft-queue-failure-handler
```

Register the module in your `config/app.php`:

```
return [
    'modules' => [
        'queue-failure-handler' => \Noo\CraftQueueFailureHandler\Module::class,
    ],
    'bootstrap' => ['queue-failure-handler'],
];
```

Configuration
-------------

[](#configuration)

Create `config/queue-failure-handler.php`:

```