eshta/resilient-task

Resilient Task Runner, A circuit breaker implementation, highly configurable task runner with number of max retries, back-off factor, maximum sleep time, and starting sleep time.

1.0.1 2021-06-13 10:40 UTC

Requires

• php: >=7.0

Requires (Dev)

• phpmd/phpmd: ^2.7
• phpunit/phpunit: ^6.0
• squizlabs/php_codesniffer: ^3.0

MIT

• Omar Shaban

• task
• circuit breaker
• circuit-breaker
• resilient
• resilient process
• resilient procedure
• circuit breaker pattern

README

Resilient Task Runner, A circuit breaker implementation, highly configurable task runner with number of max retries, back-off factor, maximum sleep time, and starting sleep time.

Usage

Install the eshta/resilient-task package:

$ composer require eshta/resilient-task

Example

use GuzzleHttp\Exception\ConnectException;


$task = function() {
    try {
        $response = $client->request('GET', 'https://github.com/_abc_123_404');

        return $response;
    } catch (ConnectException $e) {
        echo Psr7\str($e->getRequest());
    }
};

$runner = new ResilientTaskRunner(10, 16, 0.5);
$response = $runner->run($task);

if (is_null($response)) {
    throw new MyFavouriteException('Service call failed!');
}

• try 10 times at most
• maximum sleep time between retries 16 seconds
• first sleep time is half a second
• back-off factor [2 default]: double sleeping time after each failed attempt

Note:: the runner will only stop when there is a non-null result returned by the task, or the max tries have been exhausted

Contributing

See CONTRIBUTING and Code of Conduct, if you want to make contribution (pull request) or just build and test project on your own.

Resources

• Changes History
• Bug Tracker
• Authors