README

Installation

$ composer require compwright/should-retry 

Usage with Guzzle HTTP library

The popular Guzzle HTTP library includes a retry middleware:

use Compwright\ShouldRetry\ShouldRetry; use Compwright\ShouldRetry\RetryAfter; $handler = GuzzleHttp\HandlerStack::create(); $handler->push( GuzzleHttp\Middleware::retry( new ShouldRetry(), new RetryAfter() ), 'retry' ); $client = new GuzzleHttp\Client([ 'handler' => $handler, ]);

Configuration

Both ShouldRetry and RetryAfter are configurable via setters:

$shouldRetry = (new ShouldRetry()) ->setMaxRetries(5) ->setRetryOnStatusCodes(429) ->setLogger($logger); // attach PSR-3 debug logger $retryAfter = (new RetryAfter()) ->setRetryAfterHeader('x-rate-limit-reset') ->setFallbackStrategy($fallback);

Default configuration:

• Retry up to 3 times
• Retry on 429, 500, 502, 503, 504 error codes
• When retrying, wait Retry-After seconds
• If header is missing, use exponential backoff

License

MIT License