Circuit Breaker pattern implementation in PHP

1.0.0 2019-06-24 18:48 UTC

This package is auto-updated.

Last update: 2023-09-25 04:57:32 UTC


Build Status Coverage Status Latest Stable Version Total Downloads


This is a Circuit Breaker pattern implementation in PHP.

This library helps you to handle external services timeouts and outages.


  • PHP >= 7.2
  • Any cache library implementing psr/simple-cache


composer require los/cerberus:^1.0


You can manually create a Cerberus instance or use a Factory


'factories' => [
    Los\Cerberus\Cerberus::class => Los\Cerberus\CerberusFactory::class

and copy the configuration file config/cerberus.global.php.dist to your config/autoload/cerberus.global.php and change to your needs.

return [
    'cerberus' => [
        'max_failures' => 5,
        'timeout' => 60,

The maxFailure parameter is the number of failures after which the circuit is opened and the service becomes not available.

When the timeout is reached, the circuit becomes half opened and one attempt is possible and the status is updated.

The factory pull the cache from the container using


so you need to have one implemented.


You can create a Cerberus instance manually:

$storage = new Cache(); // Any psr/simple-cache implementation
$cerberus = new Cerberus($storage, 5, 60);


The usage is simple. Each time you will access a remote resource (like an Web Service), check for its availability and report its success or failure:

if ($cerberus->isAvailable()) {
    try {
    } catch (\Exception $ex) {

You can use Cerberus to control more than one service. In this scenario, use the methods passing a service name:

if ($cerberus->isAvailable('service-one')) {
    try {
    } catch (\Exception $ex) {

if ($cerberus->isAvailable('service-two')) {
    try {
    } catch (\Exception $ex) {