Download the PHP package jorisnoo/craft-queue-failure-handler without Composer
On this page you can find all versions of the php package jorisnoo/craft-queue-failure-handler. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download jorisnoo/craft-queue-failure-handler
More information about jorisnoo/craft-queue-failure-handler
Files in jorisnoo/craft-queue-failure-handler
Package craft-queue-failure-handler
Short Description Release matching queue jobs after they fail, instead of leaving them in the failed-jobs list. Pairs with webhubworks/craft-flare for reporting.
License MIT
Homepage https://github.com/jorisnoo/craft-queue-failure-handler
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package 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 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
- PHP 8.2+
- Craft CMS 5
- (Optional but recommended)
webhubworks/craft-flarefor error reporting
Installation
Register the module in your config/app.php:
Configuration
Create config/queue-failure-handler.php:
Each rule is either:
- A callable
fn(\yii\queue\ExecEvent $event): bool— full control, do whatever you want with the event. - An array with optional
jobClassandmessagekeys. Both must match if both are present.jobClass— fully-qualified class name; matched withinstanceof.message— matched against$event->error->getMessage(). Substring by default, regex if it starts with/.
When a rule matches, the queue row is deleted and $event->retry is set to false. Errors that don't match any rule keep Craft's default behaviour (retry until attempts are exhausted, then sit in the failed list).
How It Works
The module listens on craft\queue\Queue::EVENT_AFTER_ERROR. When a rule matches, it calls Craft::$app->getQueue()->release($event->id) to drop the job from the queue table.
It does not report errors itself. If webhubworks/craft-flare is installed, its own listener on the same event handles reporting — the report still lands in Flare even though the queue row is gone.
License
MIT — see LICENSE.md.
