ekomobile/retry

Retry with backoff

0.4.0 2018-12-13 12:14 UTC

Requires

• php: >=7.1

Requires (Dev)

• phpunit/phpunit: ^7.5.0

MIT

• Alexander Zhuravlev

README

This is a PHP port of https://github.com/cenkalti/backoff (thanks, @cenkalti), which is a port of the exponential backoff algorithm from Google's HTTP Client Library for Java.

Exponential backoff is an algorithm that uses feedback to multiplicatively decrease the rate of some process, in order to gradually find an acceptable rate. The retries exponentially increase and stop increasing when a certain threshold is met.

Examples

Simple

Retry with default exponential backoff.

(new Retry(function () {
    // workload ...
}))();

Advanced

$operation = function () {
  // workload ...
  if ($somePermanentFailCondition) {
    throw new \Ekomobile\Retry\Exception\Permanent(new \Exception('Unretryable error'))
  }
  // ...
  throw new Exception('Retryable error')
};

$backoff = new \Ekomobile\Retry\Backoff\WithMaxRetries(new \Ekomobile\Retry\Backoff\Exponential(), 5);

$notify = function (\Throwable $e) {
  // $logger->log($e);
};

$retry = new \Ekomobile\Retry\Retry($operation, $backoff, $notify);
$retry();