Installation

phil/circuit-breaker-bundle

Requirements

Package	Version	Why
PHP	8.5 or later
`phil/circuit-breaker`	`^0.1`	The keys, policies, state machine and breakers.
`symfony/config`, `symfony/dependency-injection`, `symfony/http-kernel`, `symfony/http-foundation`	`^8.2`	The configuration, the services and the profiler collector.
`psr/clock`	`^1.0`	The windows and open durations are measured on the application's clock.
`psr/cache`	`^3.0`	The default store of states, over a cache pool; not needed with a store of your own.
`symfony/http-client`	`^8.2`	The clients put behind their circuits; not needed without `http_client`.
`symfony/web-profiler-bundle`	`^8.2`	The profiler panel; nothing is collected without it.

Installing

composer require phil/circuit-breaker-bundle

// config/bundles.php
return [
    // ...
    Phil\CircuitBreakerBundle\PhilCircuitBreakerBundle::class => ['all' => true],
];

The cache pool

The default store keeps the states in cache.app. A circuit open in one worker is open in all only when they share that pool: on several servers, give the circuits a pool on a shared adapter, such as Redis.

# config/packages/cache.yaml
framework:
    cache:
        pools:
            cache.circuits:
                adapter: cache.adapter.redis

# config/packages/phil_circuit_breaker.yaml
phil_circuit_breaker:
    cache_pool: cache.circuits

A pool that loses an entry closes that circuit, which is the safe direction: calls resume, and the circuit trips again if the third party is still failing.