Guzzle 7 Released


June 30th, 2020

Guzzle 7 Released

The popular Guzzle HTTP client reached version 7 last week, with the exciting news that most users (the changelog says 95% of users) will be able to upgrade without modification. This release focused on increasing the minimum supported PHP version and introducing new language features found in PHP 7.

The main features of the 7.0 release include:

  • Implement PSR-18
  • Dropped PHP 5 support—the minimum PHP version is now 7.2
  • Type hints and return types for functions and methods have been added whenever possible
  • IDN support for redirects (see #2424 for details)

Be sure to check out the 6.0 to 7.0 upgrade guide for a list of known backward compatibility breaking changes with 6.x.

One update I found of note was client HTTP methods (i.e., get, post, etc.) with strong typing:

The get, head, put, post, patch, delete, getAsync, headAsync, putAsync, postAsync, patchAsync, and deleteAsync methods are now implemented as genuine methods on GuzzleHttp\Client, with strong typing. The original __call implementation remains unchanged for now, for maximum backward compatibility, but won’t be invoked under normal operation.

If you still need to access the v6 documentation and otherwise may need to use both Guzzle 6 and 7, check out the version guidance table in the project’s readme. At the time of writing, the latest docs have “Guzzle 6” in the heading, but are the Latest Guzzle 7 docs.

Release Notes

If you’re interested in the source code changes leading to v7.0.0, you can compare Guzzle 6.5 to 7.0. Below are the release notes from the project’s changelog:

7.0.1 – 2020-06-27

  • Fix multiply defined functions fatal error #2699

7.0.0 – 2020-06-27

No changes since 7.0.0-rc1.

7.0.0-rc1 – 2020-06-15


  • Use error level for logging errors in Middleware #2629
  • Disabled IDN support by default and require ext-intl to use it #2675

7.0.0-beta2 – 2020-05-25


  • Using Utils class instead of functions in the GuzzleHttp namespace. #2546
  • ClientInterface::MAJOR_VERSION #2583


  • Avoid the getenv function when unsafe #2531
  • Added real client methods #2529
  • Avoid functions due to global install conflicts #2546
  • Use Symfony intl-idn polyfill #2550
  • Adding methods for HTTP verbs like Client::get(), Client::head(), Client::patch() etc #2529
  • ConnectException extends TransferException #2541
  • Updated the default User Agent to “GuzzleHttp/7” #2654


  • Various intl icu issues #2626


  • Pool option pool_size #2528

7.0.0-beta1 – 2019-12-30



  • Dont allow passing null as third argument to BadResponseException::__construct() #2427
  • Use SAPI constant instead of method call #2450
  • Use native function invocation #2444
  • Better defaults for PHP installations with old ICU lib 2454
  • Added visibility to all constants #2462
  • Dont allow passing null as URI to Client::request() and Client::requestAsync() #2461
  • Widen the exception argument to throwable #2495


  • Logging when Promise rejected with a string #2311


  • Class SeekException #2162
  • RequestException::getResponseBodySummary() #2425
  • CookieJar::getCookieValue() #2433
  • uri_template() and UriTemplate #2440
  • Request options save_to and exceptions #2464

Filed in:

Paul Redmond

Full stack web developer. Author of Lumen Programming Guide and Docker for PHP Developers.