<?php namespace GuzzleHttp; use GuzzleHttp\Promise as P; use GuzzleHttp\Promise\PromiseInterface; use Psr\Http\Message\RequestInterface; use Psr\Http\Message\ResponseInterface; /** * Middleware that retries requests based on the boolean result of * invoking the provided "decider" function. * * @final */ class RetryMiddleware { /** * @var callable(RequestInterface, array): PromiseInterface */ private $nextHandler; /** * @var callable */ private $decider; /** * @var callable(int) */ private $delay; /** * @param callable $decider Function that accepts the number of retries, * a request, [response], and [exception] and * returns true if the request is to be * retried. * @param callable(RequestInterface, array): PromiseInterface $nextHandler Next handler to invoke. * @param (callable(int): int)|null $delay Function that accepts the number of retries * and returns the number of * milliseconds to delay. */ public function __construct(callable $decider, callable $nextHandler, callable $delay = null) { $this->decider = $decider; $this->nextHandler = $nextHandler; $this->delay = $delay ?: __CLASS__ . '::exponentialDelay'; } /** * Default exponential backoff delay function. * * @return int milliseconds. */ public static function exponentialDelay(int $retries): int { return (int) \pow(2, $retries - 1) * 1000; } public function __invoke(RequestInterface $request, array $options): PromiseInterface { if (!isset($options['retries'])) { $options['retries'] = 0; } $fn = $this->nextHandler; return $fn($request, $options) ->then( $this->onFulfilled($request, $options), $this->onRejected($request, $options) ); } /** * Execute fulfilled closure */ private function onFulfilled(RequestInterface $request, array $options): callable { return function ($value) use ($request, $options) { if (!($this->decider)( $options['retries'], $request, $value, null )) { return $value; } return $this->doRetry($request, $options, $value); }; } /** * Execute rejected closure */ private function onRejected(RequestInterface $req, array $options): callable { return function ($reason) use ($req, $options) { if (!($this->decider)( $options['retries'], $req, null, $reason )) { return P\Create::rejectionFor($reason); } return $this->doRetry($req, $options); }; } private function doRetry(RequestInterface $request, array $options, ResponseInterface $response = null): PromiseInterface { $options['delay'] = ($this->delay)(++$options['retries'], $response, $request); return $this($request, $options); } }
Name | Type | Size | Permission | Actions |
---|---|---|---|---|
Cookie | Folder | 0755 |
|
|
Exception | Folder | 0755 |
|
|
Handler | Folder | 0755 |
|
|
BodySummarizer.php | File | 631 B | 0644 |
|
BodySummarizerInterface.php | File | 233 B | 0644 |
|
Client.php | File | 17.94 KB | 0644 |
|
ClientInterface.php | File | 2.83 KB | 0644 |
|
ClientTrait.php | File | 8.79 KB | 0644 |
|
HandlerStack.php | File | 8.52 KB | 0644 |
|
MessageFormatter.php | File | 7.63 KB | 0644 |
|
MessageFormatterInterface.php | File | 561 B | 0644 |
|
Middleware.php | File | 10.9 KB | 0644 |
|
Pool.php | File | 4.61 KB | 0644 |
|
PrepareBodyMiddleware.php | File | 3.07 KB | 0644 |
|
RedirectMiddleware.php | File | 7.96 KB | 0644 |
|
RequestOptions.php | File | 10.32 KB | 0644 |
|
RetryMiddleware.php | File | 3.53 KB | 0644 |
|
TransferStats.php | File | 3.11 KB | 0644 |
|
Utils.php | File | 12.79 KB | 0644 |
|
functions.php | File | 5.56 KB | 0644 |
|
functions_include.php | File | 162 B | 0644 |
|