2017 © Pedro Peláez
 

library cerberus

Circuit Breaker pattern implementation in PHP

image

mt-olympus/cerberus

Circuit Breaker pattern implementation in PHP

  • Friday, July 22, 2016
  • by Lansoweb
  • Repository
  • 1 Watchers
  • 4 Stars
  • 7,253 Installations
  • PHP
  • 2 Dependents
  • 0 Suggesters
  • 1 Forks
  • 0 Open issues
  • 5 Versions
  • 11 % Grown

The README.md

Cerberus

Build Status Coverage Status Latest Stable Version Total Downloads Scrutinizer Code Quality SensioLabs Insight, (*1)

Introduction

This is a Circuit Breaker pattern implementation in PHP., (*2)

This library helps you to handle external services timeouts and outages., (*3)

It detects service failures and adapts itself., (*4)

You can combine this library with Metis to have a realiable Load Balance service., (*5)

Requirements

Instalation

composer require mt-olympus/cerberus:~1.0

Configuration

You can manually create a Cerberus instance or use a Factory, (*6)

Factory

If you use a Container Interopt campatible project, you can define a factory:, (*7)

'factories' => [
    Cerberus\Cerberus::class => Cerberus\Factory::class
],

and copy the configuration file config/cerberus.global.php.dist to your config/autoload/cerberus.global.php and change to your needs., (*8)

return [
    'cerberus' => [
        'max_failues' => 5,
        'timeout' => 60,
        'storage' => [
            'adapter' => [
                'name' => 'filesystem',
                'options' => [
                    'cache_dir' => 'data/cache',
                    'namespace' => 'my_project'
                ]
            ],
            'plugins' => [
                // Don't throw exceptions on cache errors
                'exception_handler' => [
                    'throw_exceptions' => false
                ]
            ]
        ]
    ]
];

The maxFailure parameter is the number of failures after which the circuit is opened and the service becomes not available., (*9)

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

The storage key is a zend-cache configuration. You can check the official documentation., (*11)

The namespace key inside the storage is important. It defines de default namespace for Cerberus cache capabilities. If you choose to call Cerberus methods with service name (see Usage bellow), you can ommit this as it will be ignored., (*12)

Manually

You can create a Cerberus instance manually:, (*13)

$storage = StorageFactory::factory($storageConfig);
$cerberus = new Cerberus($storage, 5, 60);

The $storageConfig is the zend-cache configuration as above., (*14)

Usage

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:, (*15)

if ($cerberus->isAvailable()) {
    try {
        $http->makeRequest();
        $cerberus->reportSuccess();
    } catch (\Exception $ex) {
        $cerberus->reportFailure();
    }
}

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

if ($cerberus->isAvailable('service-one')) {
    try {
        $http->makeRequest();
        $cerberus->reportSuccess('service-one');
    } catch (\Exception $ex) {
        $cerberus->reportFailure('service-one');
    }
}

if ($cerberus->isAvailable('service-two')) {
    try {
        $http->makeRequest();
        $cerberus->reportSuccess('service-two');
    } catch (\Exception $ex) {
        $cerberus->reportFailure('service-two');
    }
}

The Versions