Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/leocarmo/circuit-breaker-php
Circuit Breaker Pattern for PHP
https://github.com/leocarmo/circuit-breaker-php
circuit-breaker circuit-breaker-pattern failure-handling
Last synced: 2 months ago
JSON representation
Circuit Breaker Pattern for PHP
- Host: GitHub
- URL: https://github.com/leocarmo/circuit-breaker-php
- Owner: leocarmo
- Created: 2019-06-30T14:11:35.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-03-11T20:58:55.000Z (10 months ago)
- Last Synced: 2024-04-24T16:37:29.947Z (9 months ago)
- Topics: circuit-breaker, circuit-breaker-pattern, failure-handling
- Language: PHP
- Homepage:
- Size: 62.5 KB
- Stars: 268
- Watchers: 4
- Forks: 22
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-swoole - leocarmo/circuit-breaker-php - PHP implementation of Circuit Breaker Pattern. (Architectural)
README
# PHP implementation of Circuit Breaker Pattern
[](https://travis-ci.org/leocarmo/circuit-breaker-php)
[](https://scrutinizer-ci.com/g/leocarmo/circuit-breaker-php/?branch=master)
[](https://scrutinizer-ci.com/code-intelligence)
[](https://packagist.org/packages/leocarmo/circuit-breaker-php)
For more information about this pattern see [this](https://martinfowler.com/bliki/CircuitBreaker.html).
## Starting with composer
```sh
composer require leocarmo/circuit-breaker-php
```
## Adapters
- [Redis](#redis-adapter)
- [Redis Cluster](#redis-cluster-adapter)
- [Swoole Table](#swooletable-adapter)
### Redis Adapter
The first argument is a redis connection, the second is your product name, for redis namespace avoid key conflicts with another product using the same redis.
```php
use LeoCarmo\CircuitBreaker\CircuitBreaker;
use LeoCarmo\CircuitBreaker\Adapters\RedisAdapter;
// Connect to redis
$redis = new \Redis();
$redis->connect('localhost', 6379);
$adapter = new RedisAdapter($redis, 'my-product');
// Set redis adapter for CB
$circuit = new CircuitBreaker($adapter, 'my-service');
```
> See [this](examples/RedisAdapterExample.php) for full example
### Redis Cluster Adapter
Without use of [`multi`](https://redis.io/commands/multi/) command.
The first argument is a redis connection, the second is your product name, for redis namespace avoid key conflicts with another product using the same redis.
```php
use LeoCarmo\CircuitBreaker\CircuitBreaker;
use LeoCarmo\CircuitBreaker\Adapters\RedisClusterAdapter;
// Connect to redis
$redis = new \Redis();
$redis->connect('localhost', 6379);
$adapter = new RedisClusterAdapter($redis, 'my-product');
// Set redis adapter for CB
$circuit = new CircuitBreaker($adapter, 'my-service');
```
> See [this](examples/RedisClusterAdapterExample.php) for full example
### SwooleTable Adapter
```php
use LeoCarmo\CircuitBreaker\CircuitBreaker;
$circuit = new CircuitBreaker(new SwooleTableAdapter(), 'my-service');
```
## Guzzle Middleware
```php
use GuzzleHttp\Client;
use GuzzleHttp\HandlerStack;
use LeoCarmo\CircuitBreaker\GuzzleMiddleware;
$handler = new GuzzleMiddleware($circuit);
$handlers = HandlerStack::create();
$handlers->push($handler);
$client = new Client(['handler' => $handlers]);
$response = $client->get('leocarmo.dev');
```
*Important*: all status code between 200 and 299 will be recorded as a success, and other status will be recorded as a failure.
> See [this](examples/GuzzleMiddlewareExample.php) for full example
### Customize success status code
If you need to specify a custom status code that is not a failure, you can use:
```php
$handler = new GuzzleMiddleware($circuit);
$handler->setCustomSuccessCodes([400]);
```
*Important:* this configuration will record a success when a status code `400` is returned
> See [this](examples/GuzzleMiddlewareCustomCodeExample.php) for full example
### Ignore status code
If you want to ignore the status code returned and not record a success or failure, use this:
```php
$handler = new GuzzleMiddleware($circuit);
$handler->setCustomIgnoreCodes([412]);
```
> [!IMPORTANT]
> To use `Customize success status code` or `Ignore status code` you must set the [Guzzle client config `http_errors = false`](https://docs.guzzlephp.org/en/stable/request-options.html#http-errors) because the Guzzle Client throws a `ClientException` or `ServerException` when the status code is not in range `>200 && <300`.
## Set circuit break settings
> This is not required, default values will be set
```php
$circuit->setSettings([
'timeWindow' => 60, // Time for an open circuit (seconds)
'failureRateThreshold' => 50, // Fail rate for open the circuit
'intervalToHalfOpen' => 30, // Half open time (seconds)
]);
```
## Check if circuit is available (closed)
Each check is for a specific service. So you can have multiple services in the same application, and when one circuit is open, the other works normally.
```php
// Check circuit status for service
if (! $circuit->isAvailable()) {
die('Circuit is not available!');
}
```
## Record success and failure
```php
// Usage example for success and failure
try {
myService();
$circuit->success();
} catch (RuntimeException $e) {
// If an error occurred, it must be recorded as failure.
$circuit->failure();
}
```
## Development
### Setup
```shell
make setup
```
### Tests
```sh
make test
```
## Contributors
