PHPackages                             wal3fo/laravel-sentinel - 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. wal3fo/laravel-sentinel

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

wal3fo/laravel-sentinel
=======================

Production-ready circuit breaker package for Laravel queue jobs and service calls.

v1.0.0(3mo ago)10MITPHPPHP ^8.1

Since Apr 18Pushed 3mo agoCompare

[ Source](https://github.com/wal3fo/Laravel-fail-safe)[ Packagist](https://packagist.org/packages/wal3fo/laravel-sentinel)[ RSS](/packages/wal3fo-laravel-sentinel/feed)WikiDiscussions main Synced 3w ago

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

Wal3fo Laravel Sentinel
=======================

[](#wal3fo-laravel-sentinel)

[![Packagist Version](https://camo.githubusercontent.com/6f4fba0d9b07fef1c4de01a4662ae34e9fbd14a7edfbdc44cc4734958c52863d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f77616c33666f2f6c61726176656c2d73656e74696e656c3f7374796c653d666c61742d73717561726526636f6c6f723d366565376237266c6162656c436f6c6f723d306431313137)](https://packagist.org/packages/wal3fo/laravel-sentinel)[![Total Downloads](https://camo.githubusercontent.com/63cb70b449a7709574d5d6e21b3d88b1b28c4ad7dde5a44f1945b0f23823a003/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f77616c33666f2f6c61726176656c2d73656e74696e656c3f7374796c653d666c61742d73717561726526636f6c6f723d383138636638266c6162656c436f6c6f723d306431313137)](https://packagist.org/packages/wal3fo/laravel-sentinel)[![PHP](https://camo.githubusercontent.com/672fbc4fbeec8445ef611e4b010bcdb10c8d28165d5e8511cef038310cd446b9/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e312532422d3737374242343f7374796c653d666c61742d737175617265266c6162656c436f6c6f723d306431313137)](https://php.net)[![Laravel](https://camo.githubusercontent.com/7ed93cd2304647f31b134a251f2e2bf7b69c45d9cf6b953113d8281c0ef02717/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d31302b2d4646324432303f7374796c653d666c61742d737175617265266c6162656c436f6c6f723d306431313137)](https://laravel.com)[![License](https://camo.githubusercontent.com/099c969f9012f78a3c307ceb22eca55023dfbf8204cc6ac73344bb31c3d083e5/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f77616c33666f2f6c61726176656c2d73656e74696e656c3f7374796c653d666c61742d73717561726526636f6c6f723d666239323363266c6162656c436f6c6f723d306431313137)](LICENSE)

Production-ready circuit breaker for Laravel queues and service calls, built to stop cascading failures with closed, open, and half-open states.

Introduction
------------

[](#introduction)

When a dependency starts failing (mail API, payment gateway, CRM, webhook target), retries alone can overload workers and amplify outages. A circuit breaker prevents that by temporarily short-circuiting failing paths, then probing recovery in a controlled way.

Wal3fo Laravel Sentinel is designed for Laravel queue-heavy applications where resilience and predictable failure handling matter. Use it when:

- jobs call unstable or rate-limited external services
- multiple workers can overwhelm a failing dependency
- you need controlled backoff and safe recovery behavior
- you want observable state transitions and operational commands

Features
--------

[](#features)

- Queue middleware for automatic circuit checks and job release behavior
- Full circuit lifecycle: `closed`, `open`, `half_open`
- Cache-backed state and counters (Redis strongly recommended)
- Per-service configuration overrides
- Pluggable failure classification via contract
- Artisan commands for status and manual control
- Transition events for monitoring and alerting
- Laravel `10`, `11`, `12`, and `13` support

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

[](#installation)

```
composer require wal3fo/laravel-sentinel
```

Publish the package configuration:

```
php artisan vendor:publish --tag=sentinel-config
```

Tip

Use Redis as the cache backend for distributed queue workers and reliable lock behavior.

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

[](#configuration)

Sentinel is configured in `config/sentinel.php`.

Global defaults are defined under `defaults`, then selectively overridden per service under `services`.

```