aedart/athenaeum-circuits

Circuit Breaker for Laravel

8.15.0 2024-11-21 08:34 UTC

Requires

• php: ^8.2
• aedart/athenaeum-contracts: ^8.15
• aedart/athenaeum-support: ^8.15
• aedart/athenaeum-utils: ^8.15
• illuminate/cache: ^v11.33.2
• illuminate/events: ^v11.33.2

BSD-3-Clause

• Alin Eugen Deac

• circuit breaker
• Athenaeum

README

This package offers a Circuit Breaker that can be used to "[...] detect failures and encapsulates the logic of preventing a failure from constantly recurring, during maintenance, temporary external system failure or unexpected system difficulties[...]" (wiki).

A detailed explanation of how the Circuit Breaker Pattern works, can be found on Medium and Martin Fowler's blog

Example

<?php

use Aedart\Circuits\Traits\CircuitBreakerManagerTrait;

class WeatherService
{
    use CircuitBreakerManagerTrait;

    public function forecast()
    {
        $circuitBreaker = $this->getCircuitBreakerManager()
                ->create('weather_service');

        return $circuitBreaker->attempt(function() {
            // Perform 3rd party API call... not shown here
        }, function(){
            // Service has failed and is unavailable, do something else...
        });
    }
}

Documentation

Please read the official documentation for additional information.

Repository

The mono repository is located at github.com/aedart/athenaeum

Versioning

This package follows Semantic Versioning 2.0.0

License

BSD-3-Clause, Read the LICENSE file included in this package