NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #867 most downloaded on Packagist
Guzzle v8 retry middleware that handles 429/503 status codes and connection timeouts
Latest stable
v3.0.0
Last release 3 months ago
02 Aug 2026
Ships fairly regularly
a new release about every 7 months
Nearly every release is documented
notes for 22 of 22 stable releases
Nothing withdrawn
no release was ever pulled
9 years old
22 releases · first in 2017
Drag across the ruler to compare, or tap a release to open it.
Minimum PHP version is now 7.4 (required by Guzzle 8)
php_codesniffer and phpstan packagesDelay is now set in the options array rather than using usleep . This prevents blocking when running parallel requests (thanks @teandr ).
usleep. This prevents blocking when running parallel requests (thanks @teandr).Your coding agent can read these notes before it upgrades. Set up the MCP server →
Added GitHub build action for PHP 8.4
action/checkout and action/cachedoRetry method (for PHP 8.4)Support for connection reset by peer (thanks @fredericgboutin-yapla )
Include RequestInterface as should_retry_callback argument when triggered (thanks @Nicolai- ).
should_retry_callback argument when triggered (thanks @Nicolai-)..scrutinizer.yml file (not used anymore)Include on_retry_callback argument when triggered by onRejected (thanks @ViktorCollin )
on_retry_callback argument when triggered by onRejected (thanks @ViktorCollin)give_up_after_secs expires, and fail quickly (thanks @ruben9227)New retry_on_methods parameter .
New should_retry_callback parameter .
should_retry_callback parameter.README updatesComposer 2.2+ security issue with installing phpstan/extension-installer
phpstan/extension-installerXDEBUG_MODE environment variable is set when running PHPUnitAdditional build checks (PHPStan and PHP-CS)
GuzzleRetryMiddleware::__construct method final$options parameter comments PHPStan was complaining aboutshouldRetryHttpResponse values assume that the $response parameter is not null$dateFormat is never NULL or empty string in deriveTimeoutFromHeaderMinimum allowed version of PHPUnit is v7.5
composer.jsondev-master to 2.0-dev in composer.jsonPHP 7.4 build test in .travis.yml (thanks @alexeyshockov)
.travis.yml (thanks @alexeyshockov)composer.json (thanks @alexeyshockov)declare(strict_types=1) in unit test file
declare(strict_types=1) in unit test fileNew `give_up_after_secs` parameter
give_up_after_secs parameterGitHub Actions build status badge in README.md
README.mdRetry-After header via new retry_after_date_format optionmax_allowable_timeout_secs option to set a ceiling on the maximum time the client is willing to wait between requestsGithub Build.travis.yml build support (switched to Github Actions)Ability to handle non-integer values in Retry-After headers (thanks @andrewdalpino)
Retry-After headers (thanks @andrewdalpino)composer.jsonOption to specify custom HTTP header name other than `Retry-After` (thanks @jamesaspence)
Retry-After (thanks @jamesaspence).gitignore (minor)phpunit.xml.dist to latest spec.travis.ymlPHP 7 goodness: declare(strict_types=1) and method return signatures
declare(strict_types=1) and method return signatures.travis.yml$request and $options variables are now passed by reference in the retry callback to allow for modification (thanks @Krunch!).travis.yml fileAdded expose_retry_header and retry_header options for debugging purposes (thanks, @coudenysj)
expose_retry_header and retry_header options for debugging purposes (thanks, @coudenysj)composer.json (match Guzzle composer.json PHPUnit requirements)testRetryOccursWhenStatusCodeMatchesProvider
→ providerForRetryOccursWhenStatusCodeMatches)phpunit.xml.dist specification so that PHPUnit no longer emits warningshhvm tests in Travis CI; they were causing builds to failAdded ability to retry on connect or request timeout (retry_on_timeout option)
retry_on_timeout option)on_retry_callback callback. Response object is no longer guaranteed to be present,
so the callback signature now looks like this:
(int $retryCount, int $delayTimeout, RequestInterface $request, array $options, ResponseInterface|null $response).Everything; this is the initial version.
Added retry_enabled parameter to allow quick disable of retry on specific requests
retry_enabled parameter to allow quick disable of retry on specific requestsdefault_retry_multiplier in order to implement custom delay logicOne column per quarter.