BlueGit

projects-timfalken-com microchess

Files

microchess / web / lib / push / vendor / guzzlehttp / guzzle / CHANGELOG.md

CHANGELOG.md

CHANGELOG.md 101.9 KiB Download Raw

Change Log

Please refer to UPGRADING guide for upgrading to a major version.

7.15.5 - 2026-08-24

Changed

  • Adjusted guzzlehttp/psr7 version constraint to ^2.13.1
  • Adjusted guzzlehttp/promises version constraint to ^2.5.3

7.15.4 - 2026-08-24

Added

  • Added support for PHP 8.6

Changed

  • Replace the deprecated spl_object_hash() in handler stack debug output for PHP 8.6

7.15.3 - 2026-08-05

Changed

  • Adjusted guzzlehttp/promises version constraint to ^2.5.2

Fixed

  • Fail a cURL multi handler wait with an attributable error when the transfer is no longer tracked
  • Fix StreamHandler resolving numeric IPv4 hosts differently from cURL handlers on macOS and Windows
  • Fix StreamHandler TLS peer names and proxy authorities for numeric IPv4 hosts on all platforms
  • Settle a cURL multi handler transfer displaced by a request reusing its native handle ID

7.15.2 - 2026-07-26

Security

  • Reject non-printable-ASCII and percent-escaped URI hosts and Host headers (GHSA-v5mv-p594-2x33)
  • Reject request URI hosts that contain a URI authority delimiter (GHSA-v5mv-p594-2x33)
  • Reject numeric-looking URI hosts with trailing dots, read as IPv4 addresses (GHSA-v5mv-p594-2x33)
  • Treat numeric-in-any-base and percent-escaped cookie domains as exact-match-only (GHSA-f7vp-7xgx-4w4r)
  • Regenerate a derived Host header after client URI rewrites (GHSA-v5mv-p594-2x33)

Fixed

  • Preserve RequestException when the stream handler rejects a request before opening a stream

7.15.1 - 2026-07-18

Security

  • Preserve host-only cookie scope and require explicit persistence markers (GHSA-wm3w-8rrp-j577)
  • Bound response cookie admission and generated Cookie headers (GHSA-f283-ghqc-fg79)
  • Exclude URI fragments from Referer headers generated for redirects (GHSA-h95v-h523-3mw8)

7.15.0 - 2026-07-17

Added

  • Added Multiplexing::NONE support as a client, cURL multi handler, and conditional request option

Changed

  • Adjusted guzzlehttp/psr7 version constraint to ^2.13
  • Use locale-independent ASCII folding for all case normalization and comparison
  • Bound cURL upload reads to the declared Content-Length
  • Sanitize the cURL error text exposed through exception handler context
  • Fail closed when a named cURL multi connection cap cannot be applied
  • Reject the request-level CURLOPT_SHARE cURL option when named connection caps are configured
  • Strengthen old-libcurl SOCKS isolation for raw CURLOPT_PRE_PROXY and opaque share handles
  • Isolate HTTP proxy tunnels from opaque shared connection caches
  • Trigger runtime deprecations for previously deprecated functionality in 7.1.0

Deprecated

  • Deprecated Utils::jsonDecode() and Utils::jsonEncode() in favor of native JSON functions
  • Deprecated passing CURLMOPT_PIPELINING in the cURL multi handler options array
  • Deprecated passing CURLOPT_PROXYHEADER without cURL proxy header separation support

Fixed

  • Defer cURL requests created from multi callbacks until native execution unwinds
  • Fail synchronous waits from native cURL callbacks promptly instead of self-deadlocking
  • Guard cURL multi handle removal against progress callbacks re-entering the handler
  • Scope promise waits on the cURL multi handler to the awaited transfer
  • Strip Content-Length and Transfer-Encoding when redirects discard the request body
  • Stop re-applying the delay request option to followed redirects

7.14.2 - 2026-07-14

Security

  • Prevent first-class and proxy URL credentials from reaching origins (GHSA-94pj-82f3-465w)

7.14.1 - 2026-07-13

Changed

  • Adjusted guzzlehttp/psr7 version constraint to ^2.12.5

Fixed

  • Fail closed when a proxy tunnel isolation cURL option cannot be applied
  • Normalize Stringable proxy credential values before computing connection-reuse section signatures
  • Restore conservative credential redaction for unparseable proxies with multiple @ separators
  • Redact request URI credentials from the stream handler connection error message
  • Reject enabled response streaming (stream => true) on cap-configured stream handlers
  • Distinguish CurlMultiHandler and StreamHandler outcomes in connection-cap custom-handler guidance
  • Reject raw cURL options that conflict with explicit multiplexing guarantees
  • Stop explicit multiplexing conflict checks faulting on non-array cURL multi options values
  • Reject required multiplexing when the final CURLOPT_HTTPAUTH mask permits NTLM
  • Require an integer CURLMOPT_PIPELINING when combined with explicit multiplexing
  • Check the required multiplexing cleartext proxy rule against the final cURL configuration
  • Bound cURL multi handler blocking selects by the earliest pending request delay
  • Stop synchronous cURL multi handler waits blocking on other transfers once the target has settled
  • Stop cURL multi completion processing double-settling promises canceled from completion callbacks
  • Run ready promise queue tasks before sleeping for delayed cURL multi requests
  • Avoid integer overflow in cURL multi delay timing on 32-bit platforms
  • Roll back failed cURL multi handle attachment instead of leaving requests pending
  • Release the cURL easy handle when the on_stats callback throws
  • Normalize response trailer field names to lowercase with values in wire order
  • Retain response trailers only when an on_trailers callback is configured
  • Validate the on_trailers callback before starting a cURL transfer
  • Reject the on_trailers request option on the stream handler, which cannot observe trailers
  • Match cookies, proxy schemes, auth types, and header names with locale-independent ASCII folding
  • Reject proxy option values that Guzzle cannot classify identically to ext-curl

7.14.0 - 2026-07-08

Added

  • Added the on_trailers request option to expose parsed HTTP response trailers
  • Added the multiplex request option with Multiplexing::* modes to control or require HTTP/2 multiplexing
  • Added rejection of explicit multiplex requests when CURLMOPT_PIPELINING disables multiplexing
  • Added the max_host_connections and max_total_connections client and cURL multi handler options

Changed

  • Redirects that discard the request body no longer require it to be rewindable
  • Synchronous cURL multi handler requests no longer wait for other queued transfers
  • Section SOCKS proxy connections by credentials on libcurl before 7.69.0
  • Reject request-level CURLOPT_SHARE when combined with authenticated SOCKS proxy configuration
  • Redact proxy userinfo containing raw control bytes in cURL errors
  • Check linked curl/libcurl NTLM support before applying NTLM auth
  • Clarify that NTLM is deprecated by both Guzzle and curl/libcurl
  • Remove deprecation for the raw cURL CURLOPT_CERTINFO option
  • Warn when a cURL multi option cannot be applied

Deprecated

  • Deprecate the raw CURLOPT_PIPEWAIT cURL option in favour of the multiplex request option
  • Deprecate unknown handler constructor options
  • Deprecate invalid select_timeout cURL multi handler option values
  • Deprecate raw cURL multi connection cap options in favour of the named options

7.13.3 - 2026-07-08

Changed

  • Adjusted guzzlehttp/promises version constraint to ^2.5.1
  • Adjusted guzzlehttp/psr7 version constraint to ^2.12.4
  • Pass explicit trim characters ahead of the PHP 8.6 trim default change

Fixed

  • Stop matching cookie domains against hosts with a trailing newline
  • Reject HTTP status codes and certificate type extensions with a trailing newline
  • Treat PCRE engine failures as invalid cookie names during cookie validation
  • Report PCRE engine failures when formatting log messages
  • Report PCRE engine failures when splitting no_proxy values

7.13.2 - 2026-07-05

Fixed

  • Stop the cURL multi handler busy-waiting on request delays shorter than one second
  • Stop cURL HEAD requests with request bodies hanging on responses that declare a content length
  • The cURL handler no longer transmits request bodies on HEAD requests
  • Preserve response headers when a response includes HTTP trailers
  • Harden cURL response header block detection when HTTP trailers are received
  • Corrected the PSR-7 class names in the Pool iterator exception
  • Redirect body rewind failures no longer leak a bare RuntimeException

7.13.1 - 2026-06-29

Fixed

  • Allow middleware to rewrite partial URIs before transports validate them

7.13.0 - 2026-06-29

Added

  • Added the crypto_method_max request option to cap the maximum TLS protocol version
  • Added HTTP QUERY redirect support, preserving method and body on 301 and 302

Changed

  • Section proxy tunnel connection reuse by credential so distinct credentials never share a tunnel
  • Isolate concurrent foreign cURL proxy tunnels added while another owner's tunnel is active
  • Route credentialed HTTP(S) proxy Proxy-Authorization headers through cURL proxy header handling
  • Reject request-level CURLOPT_SHARE when combined with authenticated HTTP/HTTPS proxy tunnel configuration
  • Remove deprecation for raw cURL CURLOPT_PREREQFUNCTION callbacks when defined by PHP cURL
  • Route TLS 1.2 crypto_method requests to the stream handler when cURL cannot select TLS 1.2
  • Reject final request URIs missing a scheme or host before transfer

Deprecated

  • Deprecate invalid protocols, force_ip_resolve, delay, cookies, and allow_redirects values

7.12.3 - 2026-06-23

Changed

  • Adjusted guzzlehttp/psr7 version constraint to ^2.12.3

Security

  • Treat IP and numeric cookie domains as exact-match-only (GHSA-g446-98w2-8p5w)

7.12.2 - 2026-06-23

Fixed

  • Clamp out-of-range Max-Age so a very large value no longer overflows to an already-expired timestamp
  • Use strict comparison in CookieJar conflict resolution so distinct numeric-string names don't overwrite
  • Store a cookie whose Domain has a trailing dot on the origin host instead of silently discarding it
  • Fix StreamHandler hard-failing on bracketed IPv6 literal hosts when force_ip_resolve is set
  • Use strict cookie Path comparison so CookieJar::clear() with a numeric path keeps a distinct-path cookie
  • Fixed cookie handling for falsey Domain, Max-Age, path, and name values
  • Fixed decode_content handling for falsey string values
  • Fixed deprecated request option values reaching built-in handlers before normalization

7.12.1 - 2026-06-18

Changed

  • Adjusted guzzlehttp/psr7 version constraint to ^2.12.1

Fixed

  • Reject proxy URLs with a malformed scheme in the cURL handlers instead of letting libcurl mishandle them

Security

  • Reject HTTPS proxies when the installed libcurl lacks HTTPS-proxy support (GHSA-wpwq-4j6v-78m3)
  • Reject dot-only cookie Domain attributes as match-all (GHSA-cwxw-98qj-8qjx)

7.12.0 - 2026-06-16

Added

  • Added RequestOptions constants for curl, retries, and stream_context

Changed

  • Adjusted guzzlehttp/psr7 version constraint to ^2.12
  • Constrain cURL transport sharing to safe libcurl DNS and SSL session support
  • Resolve proxy environment variables in the cURL handlers; libcurl no longer reads the environment itself
  • Ignore proxy environment variables when the proxy request option makes a decision
  • Disable proxy environment variables on Windows SAPIs other than CLI (httpoxy hardening)
  • Redact proxy credentials from cURL handler error messages, following Psr7\Utils::redactUserInfo()
  • Normalize no-proxy domain and IP literal matching across the cURL and stream handlers

Deprecated

  • Deprecated the request-level handler option, which will be ignored in 8.0
  • Deprecated raw cURL request options outside the built-in cURL handlers' allow-list
  • Deprecated the CURLOPT_PROXYTYPE cURL request option; set the proxy type via a scheme-prefixed proxy URL
  • Deprecated PHP stream context options outside the built-in stream handler allow-list
  • Deprecated passing ntlm as a built-in auth type
  • Deprecated Utils::describeType()
  • Deprecated non-finite floats in the query and form_params options; 8.0 rejects them
  • Deprecated non-string scalar values in the body option; 8.0 rejects them

Fixed

  • Fix cURL TLS and HTTP/2 capability detection using libcurl feature checks
  • Fix proxy no list matches being re-proxied through environment-configured proxies by libcurl
  • Fix no list and NO_PROXY matching to support IP CIDR ranges, matching libcurl
  • Fix the stream handler not applying scheme-less proxies and their credentials

7.11.2 - 2026-06-12

Fixed

  • Fixed non-finite float values emitting coercion warnings on PHP 8.5

7.11.1 - 2026-06-07

Fixed

  • Ignore request-level transport_sharing, matching other unknown request options

7.11.0 - 2026-06-02

Added

  • Added support for providing the proxy request option's no value as a comma-delimited string
  • Added the protocols request option to restrict allowed URI schemes for request transfers
  • Added cert_type and ssl_key_type request options for TLS certificate and private-key file types
  • Added PHP stream handler support for the ssl_key request option
  • Added transport sharing via the transport_sharing client and cURL handler options

Changed

  • Adjusted guzzlehttp/promises version constraint to ^2.5
  • Adjusted guzzlehttp/psr7 version constraint to ^2.11
  • Allowed domainless SetCookie instances to be stored without wildcard request matching
  • Changed no-proxy matching to respect request ports for host-and-port rules
  • Prevented CurlMultiHandler destructors from throwing during cleanup
  • Improved invalid response handling across handlers

Deprecated

  • Deprecated non-iterable Pool request collections, which will be rejected in 8.0
  • Deprecated non-uppercase easy request methods; 8.0 preserves method casing
  • Deprecated non-string headers request option values, which will be rejected in 8.0
  • Deprecated empty headers request option value arrays, which will be rejected in 8.0
  • Deprecated empty and malformed request protocol versions, which will be rejected in 8.0
  • Deprecated conflicting raw cURL request options, including CURLOPT_SHARE, which will be rejected in 8.0
  • Deprecated scalar-coerced idn_conversion request option values, which will be rejected in 8.0
  • Deprecated invalid documented request option value types, which will be rejected in 8.0
  • Deprecated selected request options ignored by incompatible built-in handlers, which will be rejected in 8.0
  • Deprecated RequestException::wrapException(), which will be removed in 8.0
  • Deprecated RetryMiddleware::exponentialDelay(), which will be removed in 8.0

7.10.6 - 2026-06-01

Fixed

  • CurlMultiHandler now rejects the promise when CurlFactory::finish() throws, preserving sibling transfers
  • SetCookie now normalizes unparseable Expires values to null instead of false
  • Fix stream handler decoded gzip/deflate truncation by dropping invalid Content-Length

7.10.5 - 2026-05-27

Fixed

  • Defer cURL multi cancellation cleanup until after progress callbacks return
  • Classify additional stream handler connection failures as ConnectException

7.10.4 - 2026-05-22

Fixed

  • Fix IPv6 literal matching in no-proxy rules
  • Handle cURL multi completion messages without handles after cancelled transfers
  • Fix magic client request methods such as options() to uppercase inferred HTTP methods

7.10.3 - 2026-05-20

Fixed

  • Fail clearly when an HTTP response header line is invalid
  • Remove middleware by name when the name is also a callable string
  • Treat empty request protocol versions as HTTP/1.1

7.10.2 - 2026-05-20

Fixed

  • Normalize HTTP version request options before applying them to PSR-7 requests
  • Use string values for headers generated by request preparation and response decoding

7.10.1 - 2026-05-19

Fixed

  • Fail clearly when cURL options cannot be applied
  • Fail clearly when the certificate option is malformed
  • Fail clearly when JSON decode depth is invalid
  • Fail clearly when session cookie data is malformed
  • Fail clearly when the stream progress option is not callable
  • Prevent response creation failures from exposing stale cURL responses

7.10.0 - 2025-08-23

Added

  • Support for PHP 8.5

Changed

  • Adjusted guzzlehttp/promises version constraint to ^2.3
  • Adjusted guzzlehttp/psr7 version constraint to ^2.8

7.9.3 - 2025-03-27

Changed

  • Remove explicit content-length header for GET requests
  • Improve compatibility with bad servers for boolean cookie values

7.9.2 - 2024-07-24

Fixed

  • Adjusted handler selection to use cURL if its version is 7.21.2 or higher, rather than 7.34.0

7.9.1 - 2024-07-19

Fixed

  • Fix TLS 1.3 check for HTTP/2 requests

7.9.0 - 2024-07-18

Changed

  • Improve protocol version checks to provide feedback around unsupported protocols
  • Only select the cURL handler by default if 7.34.0 or higher is linked
  • Improved CurlMultiHandler to avoid busy wait if possible
  • Dropped support for EOL guzzlehttp/psr7 v1
  • Improved URI user info redaction in errors

7.8.2 - 2024-07-18

Added

  • Support for PHP 8.4

7.8.1 - 2023-12-03

Changed

  • Updated links in docs to their canonical versions
  • Replaced call_user_func* with native calls

7.8.0 - 2023-08-27

Added

  • Support for PHP 8.3
  • Added automatic closing of handles on CurlFactory object destruction

7.7.1 - 2023-08-27

Changed

  • Remove the need for AllowDynamicProperties in CurlMultiHandler

7.7.0 - 2023-05-21

Added

  • Support guzzlehttp/promises v2

7.6.1 - 2023-05-15

Fixed

  • Fix SetCookie::fromString MaxAge deprecation warning and skip invalid MaxAge values

7.6.0 - 2023-05-14

Added

  • Support for setting the minimum TLS version in a unified way
  • Apply on request the version set in options parameters

7.5.2 - 2023-05-14

Fixed

  • Fixed set cookie constructor validation
  • Fixed handling of files with '0' body

Changed

  • Corrected docs and default connect timeout value to 300 seconds

7.5.1 - 2023-04-17

Fixed

  • Fixed NO_PROXY settings so that setting the proxy option to no overrides the env variable

Changed

  • Adjusted guzzlehttp/psr7 version constraint to ^1.9.1 || ^2.4.5

7.5.0 - 2022-08-28

Added

  • Support PHP 8.2
  • Add request to delay closure params

7.4.5 - 2022-06-20

Fixed

  • Fix change in port should be considered a change in origin
  • Fix CURLOPT_HTTPAUTH option not cleared on change of origin

7.4.4 - 2022-06-09

Fixed

  • Fix failure to strip Authorization header on HTTP downgrade
  • Fix failure to strip the Cookie header on change in host or HTTP downgrade

7.4.3 - 2022-05-25

Fixed

  • Fix cross-domain cookie leakage

7.4.2 - 2022-03-20

Fixed

  • Remove curl auth on cross-domain redirects to align with the Authorization HTTP header
  • Reject non-HTTP schemes in StreamHandler
  • Set a default ssl.peer_name context in StreamHandler to allow force_ip_resolve

7.4.1 - 2021-12-06

Changed

  • Replaced implicit URI to string coercion #2946
  • Allow symfony/deprecation-contracts version 3 #2961

Fixed

  • Only close curl handle if it's done #2950

7.4.0 - 2021-10-18

Added

Fixed

  • Make sure we always call restore_error_handler() #2915
  • Fix progress parameter type compatibility between the cURL and stream handlers #2936
  • Throw InvalidArgumentException when an incorrect headers array is provided #2916, #2942

Changed

7.3.0 - 2021-03-23

Added

  • Support for DER and P12 certificates #2413
  • Support the cURL (http://) scheme for StreamHandler proxies #2850
  • Support for guzzlehttp/psr7:^2.0 #2878

Fixed

  • Handle exceptions on invalid header consistently between PHP versions and handlers #2872

7.2.0 - 2020-10-10

Added

  • Support for PHP 8 #2712, #2715, #2789
  • Support passing a body summarizer to the http errors middleware #2795

Fixed

  • Handle exceptions during response creation #2591
  • Fix CURLOPT_ENCODING not to be overwritten #2595
  • Make sure the Request always has a body object #2804

Changed

  • The TooManyRedirectsException has a response #2660
  • Avoid "functions" from dependencies #2712

Deprecated

  • Using environment variable GUZZLE_CURL_SELECT_TIMEOUT #2786

7.1.1 - 2020-09-30

Fixed

  • Incorrect EOF detection for response body streams on Windows.

Changed

  • We dont connect curl sink on HEAD requests.
  • Removed some PHP 5 workarounds

7.1.0 - 2020-09-22

Added

  • GuzzleHttp\MessageFormatterInterface

Fixed

  • Fixed issue that caused cookies with no value not to be stored.
  • On redirects, we allow all safe methods like GET, HEAD and OPTIONS.
  • Fixed logging on empty responses.
  • Make sure MessageFormatter::format returns string

Deprecated

  • All functions in GuzzleHttp has been deprecated. Use static methods on Utils instead.
  • ClientInterface::getConfig()
  • Client::getConfig()
  • Client::__call()
  • Utils::defaultCaBundle()
  • CurlFactory::LOW_CURL_VERSION_NUMBER

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

Changed

  • 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

Added

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

Changed

  • 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

Fixed

  • Various intl icu issues #2626

Removed

  • Pool option pool_size #2528

7.0.0-beta1 - 2019-12-30

The diff might look very big but 95% of Guzzle users will be able to upgrade without modification. Please see the upgrade document that describes all BC breaking changes.

Added

Changed

  • 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

Fixed

  • Logging when Promise rejected with a string #2311

Removed

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

6.5.2 - 2019-12-23

  • idn_to_ascii() fix for old PHP versions #2489

6.5.1 - 2019-12-21

  • Better defaults for PHP installations with old ICU lib #2454
  • IDN support for redirects #2424

6.5.0 - 2019-12-07

  • Improvement: Added support for reset internal queue in MockHandler. #2143
  • Improvement: Added support to pass arbitrary options to curl_multi_init. #2287
  • Fix: Gracefully handle passing null to the header option. #2132
  • Fix: RetryMiddleware did not do exponential delay between retires due unit mismatch. #2132
  • Fix: Prevent undefined offset when using array for ssl_key options. #2348
  • Deprecated ClientInterface::VERSION

6.4.1 - 2019-10-23

  • No guzzle.phar was created in 6.4.0 due expired API token. This release will fix that
  • Added parent::__construct() to FileCookieJar and SessionCookieJar

6.4.0 - 2019-10-23

  • Improvement: Improved error messages when using curl < 7.21.2 #2108
  • Fix: Test if response is readable before returning a summary in RequestException::getResponseBodySummary() #2081
  • Fix: Add support for GUZZLE_CURL_SELECT_TIMEOUT environment variable #2161
  • Improvement: Added GuzzleHttp\Exception\InvalidArgumentException #2163
  • Improvement: Added GuzzleHttp\_current_time() to use hrtime() if that function exists. #2242
  • Improvement: Added curl's appconnect_time in TransferStats #2284
  • Improvement: Make GuzzleException extend Throwable wherever it's available #2273
  • Fix: Prevent concurrent writes to file when saving CookieJar #2335
  • Improvement: Update MockHandler so we can test transfer time #2362

6.3.3 - 2018-04-22

  • Fix: Default headers when decode_content is specified

6.3.2 - 2018-03-26

  • Fix: Release process

6.3.1 - 2018-03-26

  • Bug fix: Parsing 0 epoch expiry times in cookies #2014
  • Improvement: Better ConnectException detection #2012
  • Bug fix: Malformed domain that contains a "/" #1999
  • Bug fix: Undefined offset when a cookie has no first key-value pair #1998
  • Improvement: Support PHPUnit 6 #1953
  • Bug fix: Support empty headers #1915
  • Bug fix: Ignore case during header modifications #1916

+ Minor code cleanups, documentation fixes and clarifications.

6.3.0 - 2017-06-22

  • Feature: force IP resolution (ipv4 or ipv6) #1608, #1659
  • Improvement: Don't include summary in exception message when body is empty #1621
  • Improvement: Handle on_headers option in MockHandler #1580
  • Improvement: Added SUSE Linux CA path #1609
  • Improvement: Use class reference for getting the name of the class instead of using hardcoded strings #1641
  • Feature: Added read_timeout option #1611
  • Bug fix: PHP 7.x fixes #1685, #1686, #1811
  • Deprecation: BadResponseException instantiation without a response #1642
  • Feature: Added NTLM auth #1569
  • Feature: Track redirect HTTP status codes #1711
  • Improvement: Check handler type during construction #1745
  • Improvement: Always include the Content-Length if there's a body #1721
  • Feature: Added convenience method to access a cookie by name #1318
  • Bug fix: Fill CURLOPT_CAPATH and CURLOPT_CAINFO properly #1684
  • Improvement: Use \GuzzleHttp\Promise\rejection_for function instead of object init #1827

+ Minor code cleanups, documentation fixes and clarifications.

6.2.3 - 2017-02-28

  • Fix deprecations with guzzle/psr7 version 1.4

6.2.2 - 2016-10-08

  • Allow to pass nullable Response to delay callable
  • Only add scheme when host is present
  • Fix drain case where content-length is the literal string zero
  • Obfuscate in-URL credentials in exceptions

6.2.1 - 2016-07-18

  • Address HTTP_PROXY security vulnerability, CVE-2016-5385:

https://httpoxy.org/

  • Fixing timeout bug with StreamHandler:

https://github.com/guzzle/guzzle/pull/1488

  • Only read up to Content-Length in PHP StreamHandler to avoid timeouts when

a server does not honor Connection: close.

  • Ignore URI fragment when sending requests.

6.2.0 - 2016-03-21

  • Feature: added GuzzleHttp\json_encode and GuzzleHttp\json_decode.

https://github.com/guzzle/guzzle/pull/1389

  • Bug fix: Fix sleep calculation when waiting for delayed requests.

https://github.com/guzzle/guzzle/pull/1324

  • Feature: More flexible history containers.

https://github.com/guzzle/guzzle/pull/1373

  • Bug fix: defer sink stream opening in StreamHandler.

https://github.com/guzzle/guzzle/pull/1377

  • Bug fix: do not attempt to escape cookie values.

https://github.com/guzzle/guzzle/pull/1406

  • Feature: report original content encoding and length on decoded responses.

https://github.com/guzzle/guzzle/pull/1409

  • Bug fix: rewind seekable request bodies before dispatching to cURL.

https://github.com/guzzle/guzzle/pull/1422

  • Bug fix: provide an empty string to http_build_query for HHVM workaround.

https://github.com/guzzle/guzzle/pull/1367

6.1.1 - 2015-11-22

  • Bug fix: Proxy::wrapSync() now correctly proxies to the appropriate handler

https://github.com/guzzle/guzzle/commit/911bcbc8b434adce64e223a6d1d14e9a8f63e4e4

  • Feature: HandlerStack is now more generic.

https://github.com/guzzle/guzzle/commit/f2102941331cda544745eedd97fc8fd46e1ee33e

  • Bug fix: setting verify to false in the StreamHandler now disables peer

verification. https://github.com/guzzle/guzzle/issues/1256

  • Feature: Middleware now uses an exception factory, including more error

context. https://github.com/guzzle/guzzle/pull/1282

  • Feature: better support for disabled functions.

https://github.com/guzzle/guzzle/pull/1287

  • Bug fix: fixed regression where MockHandler was not using sink.

https://github.com/guzzle/guzzle/pull/1292

6.1.0 - 2015-09-08

  • Feature: Added the on_stats request option to provide access to transfer

statistics for requests. https://github.com/guzzle/guzzle/pull/1202

  • Feature: Added the ability to persist session cookies in CookieJars.

https://github.com/guzzle/guzzle/pull/1195

  • Feature: Some compatibility updates for Google APP Engine

https://github.com/guzzle/guzzle/pull/1216

  • Feature: Added support for NO_PROXY to prevent the use of a proxy based on

a simple set of rules. https://github.com/guzzle/guzzle/pull/1197

  • Feature: Cookies can now contain square brackets.

https://github.com/guzzle/guzzle/pull/1237

  • Bug fix: Now correctly parsing = inside of quotes in Cookies.

https://github.com/guzzle/guzzle/pull/1232

  • Bug fix: Cusotm cURL options now correctly override curl options of the

same name. https://github.com/guzzle/guzzle/pull/1221

  • Bug fix: Content-Type header is now added when using an explicitly provided

multipart body. https://github.com/guzzle/guzzle/pull/1218

  • Bug fix: Now ignoring Set-Cookie headers that have no name.
  • Bug fix: Reason phrase is no longer cast to an int in some cases in the

cURL handler. https://github.com/guzzle/guzzle/pull/1187

  • Bug fix: Remove the Authorization header when redirecting if the Host

header changes. https://github.com/guzzle/guzzle/pull/1207

  • Bug fix: Cookie path matching fixes

https://github.com/guzzle/guzzle/issues/1129

  • Bug fix: Fixing the cURL body_as_string setting

https://github.com/guzzle/guzzle/pull/1201

  • Bug fix: quotes are no longer stripped when parsing cookies.

https://github.com/guzzle/guzzle/issues/1172

  • Bug fix: form_params and query now always uses the & separator.

https://github.com/guzzle/guzzle/pull/1163

  • Bug fix: Adding a Content-Length to PHP stream wrapper requests if not set.

https://github.com/guzzle/guzzle/pull/1189

6.0.2 - 2015-07-04

  • Fixed a memory leak in the curl handlers in which references to callbacks

were not being removed by curl_reset.

  • Cookies are now extracted properly before redirects.
  • Cookies now allow more character ranges.
  • Decoded Content-Encoding responses are now modified to correctly reflect

their state if the encoding was automatically removed by a handler. This means that the Content-Encoding header may be removed an the Content-Length modified to reflect the message size after removing the encoding.

  • Added a more explicit error message when trying to use form_params and

multipart in the same request.

  • Several fixes for HHVM support.
  • Functions are now conditionally required using an additional level of

indirection to help with global Composer installations.

6.0.1 - 2015-05-27

  • Fixed a bug with serializing the query request option where the &

separator was missing.

  • Added a better error message for when body is provided as an array. Please

use form_params or multipart instead.

  • Various doc fixes.

6.0.0 - 2015-05-26

  • See the UPGRADING.md document for more information.
  • Added multipart and form_params request options.
  • Added synchronous request option.
  • Added the on_headers request option.
  • Fixed expect handling.
  • No longer adding default middlewares in the client ctor. These need to be

present on the provided handler in order to work.

  • Requests are no longer initiated when sending async requests with the

CurlMultiHandler. This prevents unexpected recursion from requests completing while ticking the cURL loop.

  • Removed the semantics of setting default to true. This is no longer

required now that the cURL loop is not ticked for async requests.

  • Added request and response logging middleware.
  • No longer allowing self signed certificates when using the StreamHandler.
  • Ensuring that sink is valid if saving to a file.
  • Request exceptions now include a "handler context" which provides handler

specific contextual information.

  • Added GuzzleHttp\RequestOptions to allow request options to be applied

using constants.

  • $maxHandles has been removed from CurlMultiHandler.
  • MultipartPostBody is now part of the guzzlehttp/psr7 package.

5.3.0 - 2015-05-19

  • Mock now supports save_to
  • Marked AbstractRequestEvent::getTransaction() as public.
  • Fixed a bug in which multiple headers using different casing would overwrite

previous headers in the associative array.

  • Added Utils::getDefaultHandler()
  • Marked GuzzleHttp\Client::getDefaultUserAgent as deprecated.
  • URL scheme is now always lowercased.

6.0.0-beta.1

  • Requires PHP >= 5.5
  • Updated to use PSR-7
  • Requires immutable messages, which basically means an event based system

owned by a request instance is no longer possible.

  • Utilizing the Guzzle PSR-7 package.
  • Removed the dependency on guzzlehttp/streams. These stream abstractions

are available in the guzzlehttp/psr7 package under the GuzzleHttp\Psr7 namespace.

  • Added middleware and handler system
  • Replaced the Guzzle event and subscriber system with a middleware system.
  • No longer depends on RingPHP, but rather places the HTTP handlers directly

in Guzzle, operating on PSR-7 messages.

  • Retry logic is now encapsulated in GuzzleHttp\Middleware::retry, which

means the guzzlehttp/retry-subscriber is now obsolete.

  • Mocking responses is now handled using GuzzleHttp\Handler\MockHandler.
  • Asynchronous responses
  • No longer supports the future request option to send an async request.

Instead, use one of the *Async methods of a client (e.g., requestAsync, getAsync, etc.).

  • Utilizing GuzzleHttp\Promise instead of React's promise library to avoid

recursion required by chaining and forwarding react promises. See https://github.com/guzzle/promises

  • Added requestAsync and sendAsync to send request asynchronously.
  • Added magic methods for getAsync(), postAsync(), etc. to send requests

asynchronously.

  • Request options
  • POST and form updates
  • Added the form_fields and form_files request options.
  • Removed the GuzzleHttp\Post namespace.
  • The body request option no longer accepts an array for POST requests.
  • The exceptions request option has been deprecated in favor of the

http_errors request options.

  • The save_to request option has been deprecated in favor of sink request

option.

  • Clients no longer accept an array of URI template string and variables for

URI variables. You will need to expand URI templates before passing them into a client constructor or request method.

  • Client methods get(), post(), put(), patch(), options(), etc. are

now magic methods that will send synchronous requests.

  • Replaced Utils.php with plain functions in functions.php.
  • Removed GuzzleHttp\Collection.
  • Removed GuzzleHttp\BatchResults. Batched pool results are now returned as

an array.

  • Removed GuzzleHttp\Query. Query string handling is now handled using an

associative array passed into the query request option. The query string is serialized using PHP's http_build_query. If you need more control, you can pass the query string in as a string.

  • GuzzleHttp\QueryParser has been replaced with the

GuzzleHttp\Psr7\parse_query.

5.2.0 - 2015-01-27

  • Added AppliesHeadersInterface to make applying headers to a request based

on the body more generic and not specific to PostBodyInterface.

  • Reduced the number of stack frames needed to send requests.
  • Nested futures are now resolved in the client rather than the RequestFsm
  • Finishing state transitions is now handled in the RequestFsm rather than the

RingBridge.

  • Added a guard in the Pool class to not use recursion for request retries.

5.1.0 - 2014-12-19

  • Pool class no longer uses recursion when a request is intercepted.
  • The size of a Pool can now be dynamically adjusted using a callback.

See https://github.com/guzzle/guzzle/pull/943.

  • Setting a request option to null when creating a request with a client will

ensure that the option is not set. This allows you to overwrite default request options on a per-request basis. See https://github.com/guzzle/guzzle/pull/937.

  • Added the ability to limit which protocols are allowed for redirects by

specifying a protocols array in the allow_redirects request option.

  • Nested futures due to retries are now resolved when waiting for synchronous

responses. See https://github.com/guzzle/guzzle/pull/947.

  • "0" is now an allowed URI path. See

https://github.com/guzzle/guzzle/pull/935.

  • Query no longer typehints on the $query argument in the constructor,

allowing for strings and arrays.

  • Exceptions thrown in the end event are now correctly wrapped with Guzzle

specific exceptions if necessary.

5.0.3 - 2014-11-03

This change updates query strings so that they are treated as un-encoded values by default where the value represents an un-encoded value to send over the wire. A Query object then encodes the value before sending over the wire. This means that even value query string values (e.g., ":") are url encoded. This makes the Query class match PHP's http_build_query function. However, if you want to send requests over the wire using valid query string characters that do not need to be encoded, then you can provide a string to Url::setQuery() and pass true as the second argument to specify that the query string is a raw string that should not be parsed or encoded (unless a call to getQuery() is subsequently made, forcing the query-string to be converted into a Query object).

5.0.2 - 2014-10-30

  • Added a trailing \r\n to multipart/form-data payloads. See

https://github.com/guzzle/guzzle/pull/871

  • Added a GuzzleHttp\Pool::send() convenience method to match the docs.
  • Status codes are now returned as integers. See

https://github.com/guzzle/guzzle/issues/881

  • No longer overwriting an existing application/x-www-form-urlencoded header

when sending POST requests, allowing for customized headers. See https://github.com/guzzle/guzzle/issues/877

  • Improved path URL serialization.
  • No longer double percent-encoding characters in the path or query string if

they are already encoded.

  • Now properly encoding the supplied path to a URL object, instead of only

encoding ' ' and '?'.

  • Note: This has been changed in 5.0.3 to now encode query string values by

default unless the rawString argument is provided when setting the query string on a URL: Now allowing many more characters to be present in the query string without being percent encoded. See https://datatracker.ietf.org/doc/html/rfc3986#appendix-A

5.0.1 - 2014-10-16

Bugfix release.

  • Fixed an issue where connection errors still returned response object in

error and end events event though the response is unusable. This has been corrected so that a response is not returned in the getResponse method of these events if the response did not complete. https://github.com/guzzle/guzzle/issues/867

  • Fixed an issue where transfer statistics were not being populated in the

RingBridge. https://github.com/guzzle/guzzle/issues/866

5.0.0 - 2014-10-12

Adding support for non-blocking responses and some minor API cleanup.

New Features

  • Added support for non-blocking responses based on guzzlehttp/guzzle-ring.
  • Added a public API for creating a default HTTP adapter.
  • Updated the redirect plugin to be non-blocking so that redirects are sent

concurrently. Other plugins like this can now be updated to be non-blocking.

  • Added a "progress" event so that you can get upload and download progress

events.

  • Added GuzzleHttp\Pool which implements FutureInterface and transfers

requests concurrently using a capped pool size as efficiently as possible.

  • Added hasListeners() to EmitterInterface.
  • Removed GuzzleHttp\ClientInterface::sendAll and marked

GuzzleHttp\Client::sendAll as deprecated (it's still there, just not the recommended way).

Breaking changes

The breaking changes in this release are relatively minor. The biggest thing to look out for is that request and response objects no longer implement fluent interfaces.

  • Removed the fluent interfaces (i.e., return $this) from requests,

responses, GuzzleHttp\Collection, GuzzleHttp\Url, GuzzleHttp\Query, GuzzleHttp\Post\PostBody, and GuzzleHttp\Cookie\SetCookie. This blog post provides a good outline of why I did this: https://ocramius.github.io/blog/fluent-interfaces-are-evil/. This also makes the Guzzle message interfaces compatible with the current PSR-7 message proposal.

  • Removed "functions.php", so that Guzzle is truly PSR-4 compliant. Except

for the HTTP request functions from function.php, these functions are now implemented in GuzzleHttp\Utils using camelCase. GuzzleHttp\json_decode moved to GuzzleHttp\Utils::jsonDecode. GuzzleHttp\get_path moved to GuzzleHttp\Utils::getPath. GuzzleHttp\set_path moved to GuzzleHttp\Utils::setPath. GuzzleHttp\batch should now be GuzzleHttp\Pool::batch, which returns an objectStorage. Using functions.php caused problems for many users: they aren't PSR-4 compliant, require an explicit include, and needed an if-guard to ensure that the functions are not declared multiple times.

  • Rewrote adapter layer.
  • Removing all classes from GuzzleHttp\Adapter, these are now

implemented as callables that are stored in GuzzleHttp\Ring\Client.

  • Removed the concept of "parallel adapters". Sending requests serially or

concurrently is now handled using a single adapter.

  • Moved GuzzleHttp\Adapter\Transaction to GuzzleHttp\Transaction. The

Transaction object now exposes the request, response, and client as public properties. The getters and setters have been removed.

  • Removed the "headers" event. This event was only useful for changing the

body a response once the headers of the response were known. You can implement a similar behavior in a number of ways. One example might be to use a FnStream that has access to the transaction being sent. For example, when the first byte is written, you could check if the response headers match your expectations, and if so, change the actual stream body that is being written to.

  • Removed the asArray parameter from

GuzzleHttp\Message\MessageInterface::getHeader. If you want to get a header value as an array, then use the newly added getHeaderAsArray() method of MessageInterface. This change makes the Guzzle interfaces compatible with the PSR-7 interfaces.

  • GuzzleHttp\Message\MessageFactory no longer allows subclasses to add

custom request options using double-dispatch (this was an implementation detail). Instead, you should now provide an associative array to the constructor which is a mapping of the request option name mapping to a function that applies the option value to a request.

  • Removed the concept of "throwImmediately" from exceptions and error events.

This control mechanism was used to stop a transfer of concurrent requests from completing. This can now be handled by throwing the exception or by cancelling a pool of requests or each outstanding future request individually.

  • Updated to "GuzzleHttp\Streams" 3.0.
  • GuzzleHttp\Stream\StreamInterface::getContents() no longer accepts a

maxLen parameter. This update makes the Guzzle streams project compatible with the current PSR-7 proposal.

  • GuzzleHttp\Stream\Stream::__construct,

GuzzleHttp\Stream\Stream::factory, and GuzzleHttp\Stream\Utils::create no longer accept a size in the second argument. They now accept an associative array of options, including the "size" key and "metadata" key which can be used to provide custom metadata.

4.2.2 - 2014-09-08

  • Fixed a memory leak in the CurlAdapter when reusing cURL handles.
  • No longer using request_fulluri in stream adapter proxies.
  • Relative redirects are now based on the last response, not the first response.

4.2.1 - 2014-08-19

  • Ensuring that the StreamAdapter does not always add a Content-Type header
  • Adding automated github releases with a phar and zip

4.2.0 - 2014-08-17

  • Now merging in default options using a case-insensitive comparison.

Closes https://github.com/guzzle/guzzle/issues/767

  • Added the ability to automatically decode Content-Encoding response bodies

using the decode_content request option. This is set to true by default to decode the response body if it comes over the wire with a Content-Encoding. Set this value to false to disable decoding the response content, and pass a string to provide a request Accept-Encoding header and turn on automatic response decoding. This feature now allows you to pass an Accept-Encoding header in the headers of a request but still disable automatic response decoding. Closes https://github.com/guzzle/guzzle/issues/764

  • Added the ability to throw an exception immediately when transferring

requests in parallel. Closes https://github.com/guzzle/guzzle/issues/760

  • Updating guzzlehttp/streams dependency to ~2.1
  • No longer utilizing the now deprecated namespaced methods from the stream

package.

4.1.8 - 2014-08-14

  • Fixed an issue in the CurlFactory that caused setting the stream=false

request option to throw an exception. See: https://github.com/guzzle/guzzle/issues/769

  • TransactionIterator now calls rewind on the inner iterator.

See: https://github.com/guzzle/guzzle/pull/765

  • You can now set the Content-Type header to multipart/form-data

when creating POST requests to force multipart bodies. See https://github.com/guzzle/guzzle/issues/768

4.1.7 - 2014-08-07

  • Fixed an error in the HistoryPlugin that caused the same request and response

to be logged multiple times when an HTTP protocol error occurs.

  • Ensuring that cURL does not add a default Content-Type when no Content-Type

has been supplied by the user. This prevents the adapter layer from modifying the request that is sent over the wire after any listeners may have already put the request in a desired state (e.g., signed the request).

  • Throwing an exception when you attempt to send requests that have the

"stream" set to true in parallel using the MultiAdapter.

  • Only calling curl_multi_select when there are active cURL handles. This was

previously changed and caused performance problems on some systems due to PHP always selecting until the maximum select timeout.

  • Fixed a bug where multipart/form-data POST fields were not correctly

aggregated (e.g., values with "&").

4.1.6 - 2014-08-03

  • Added helper methods to make it easier to represent messages as strings,

including getting the start line and getting headers as a string.

4.1.5 - 2014-08-02

  • Automatically retrying cURL "Connection died, retrying a fresh connect"

errors when possible.

  • cURL implementation cleanup
  • Allowing multiple event subscriber listeners to be registered per event by

passing an array of arrays of listener configuration.

4.1.4 - 2014-07-22

  • Fixed a bug that caused multi-part POST requests with more than one field to

serialize incorrectly.

  • Paths can now be set to "0"
  • ResponseInterface::xml now accepts a libxml_options option and added a

missing default argument that was required when parsing XML response bodies.

  • A save_to stream is now created lazily, which means that files are not

created on disk unless a request succeeds.

4.1.3 - 2014-07-15

  • Various fixes to multipart/form-data POST uploads
  • Wrapping function.php in an if-statement to ensure Guzzle can be used

globally and in a Composer install

  • Fixed an issue with generating and merging in events to an event array
  • POST headers are only applied before sending a request to allow you to change

the query aggregator used before uploading

  • Added much more robust query string parsing
  • Fixed various parsing and normalization issues with URLs
  • Fixing an issue where multi-valued headers were not being utilized correctly

in the StreamAdapter

4.1.2 - 2014-06-18

  • Added support for sending payloads with GET requests

4.1.1 - 2014-06-08

  • Fixed an issue related to using custom message factory options in subclasses
  • Fixed an issue with nested form fields in a multi-part POST
  • Fixed an issue with using the json request option for POST requests
  • Added ToArrayInterface to GuzzleHttp\Cookie\CookieJar

4.1.0 - 2014-05-27

  • Added a json request option to easily serialize JSON payloads.
  • Added a GuzzleHttp\json_decode() wrapper to safely parse JSON.
  • Added setPort() and getPort() to GuzzleHttp\Message\RequestInterface.
  • Added the ability to provide an emitter to a client in the client constructor.
  • Added the ability to persist a cookie session using $_SESSION.
  • Added a trait that can be used to add event listeners to an iterator.
  • Removed request method constants from RequestInterface.
  • Fixed warning when invalid request start-lines are received.
  • Updated MessageFactory to work with custom request option methods.
  • Updated cacert bundle to latest build.

4.0.2 (2014-04-16) ------------------

  • Proxy requests using the StreamAdapter now properly use request_fulluri (#632)
  • Added the ability to set scalars as POST fields (#628)

4.0.1 - 2014-04-04

  • The HTTP status code of a response is now set as the exception code of

RequestException objects.

  • 303 redirects will now correctly switch from POST to GET requests.
  • The default parallel adapter of a client now correctly uses the MultiAdapter.
  • HasDataTrait now initializes the internal data array as an empty array so

that the toArray() method always returns an array.

4.0.0 - 2014-03-29

  • For information on changes and upgrading, see:

https://github.com/guzzle/guzzle/blob/4.x/UPGRADING.md#3x-to-40

  • Added GuzzleHttp\batch() as a convenience function for sending requests in

parallel without needing to write asynchronous code.

  • Restructured how events are added to GuzzleHttp\ClientInterface::sendAll().

You can now pass a callable or an array of associative arrays where each associative array contains the "fn", "priority", and "once" keys.

4.0.0.rc-2 - 2014-03-25

  • Removed getConfig() and setConfig() from clients to avoid confusion

around whether things like base_url, message_factory, etc. should be able to be retrieved or modified.

  • Added getDefaultOption() and setDefaultOption() to ClientInterface
  • functions.php functions were renamed using snake_case to match PHP idioms
  • Added support for HTTP_PROXY, HTTPS_PROXY, and

GUZZLE_CURL_SELECT_TIMEOUT environment variables

  • Added the ability to specify custom sendAll() event priorities
  • Added the ability to specify custom stream context options to the stream

adapter.

  • Added a functions.php function for get_path() and set_path()
  • CurlAdapter and MultiAdapter now use a callable to generate curl resources
  • MockAdapter now properly reads a body and emits a headers event
  • Updated Url class to check if a scheme and host are set before adding ":"

and "//". This allows empty Url (e.g., "") to be serialized as "".

  • Parsing invalid XML no longer emits warnings
  • Curl classes now properly throw AdapterExceptions
  • Various performance optimizations
  • Streams are created with the faster Stream\create() function
  • Marked deprecation_proxy() as internal
  • Test server is now a collection of static methods on a class

4.0.0-rc.1 - 2014-03-15

  • See https://github.com/guzzle/guzzle/blob/4.x/UPGRADING.md#3x-to-40

3.8.1 - 2014-01-28

  • Bug: Always using GET requests when redirecting from a 303 response
  • Bug: CURLOPT_SSL_VERIFYHOST is now correctly set to false when setting $certificateAuthority to false in

Guzzle\Http\ClientInterface::setSslVerification()

  • Bug: RedirectPlugin now uses strict RFC 3986 compliance when combining a base URL with a relative URL
  • Bug: The body of a request can now be set to "0"
  • Sending PHP stream requests no longer forces HTTP/1.0
  • Adding more information to ExceptionCollection exceptions so that users have more context, including a stack trace of

each sub-exception

  • Updated the $ref attribute in service descriptions to merge over any existing parameters of a schema (rather than

clobbering everything).

  • Merging URLs will now use the query string object from the relative URL (thus allowing custom query aggregators)
  • Query strings are now parsed in a way that they do no convert empty keys with no value to have a dangling =.

For example foo&bar=baz is now correctly parsed and recognized as foo&bar=baz rather than foo=&bar=baz.

  • Now properly escaping the regular expression delimiter when matching Cookie domains.
  • Network access is now disabled when loading XML documents

3.8.0 - 2013-12-05

  • Added the ability to define a POST name for a file
  • JSON response parsing now properly walks additionalProperties
  • cURL error code 18 is now retried automatically in the BackoffPlugin
  • Fixed a cURL error when URLs contain fragments
  • Fixed an issue in the BackoffPlugin retry event where it was trying to access all exceptions as if they were

CurlExceptions

  • CURLOPT_PROGRESS function fix for PHP 5.5 (69fcc1e)
  • Added the ability for Guzzle to work with older versions of cURL that do not support CURLOPT_TIMEOUT_MS
  • Fixed a bug that was encountered when parsing empty header parameters
  • UriTemplate now has a setRegex() method to match the docs
  • The debug request parameter now checks if it is truthy rather than if it exists
  • Setting the debug request parameter to true shows verbose cURL output instead of using the LogPlugin
  • Added the ability to combine URLs using strict RFC 3986 compliance
  • Command objects can now return the validation errors encountered by the command
  • Various fixes to cache revalidation (#437 and 29797e5)
  • Various fixes to the AsyncPlugin
  • Cleaned up build scripts

3.7.4 - 2013-10-02

  • Bug fix: 0 is now an allowed value in a description parameter that has a default value (#430)
  • Bug fix: SchemaFormatter now returns an integer when formatting to a Unix timestamp

(see https://github.com/aws/aws-sdk-php/issues/147)

  • Bug fix: Cleaned up and fixed URL dot segment removal to properly resolve internal dots
  • Minimum PHP version is now properly specified as 5.3.3 (up from 5.3.2) (#420)
  • Updated the bundled cacert.pem (#419)
  • OauthPlugin now supports adding authentication to headers or query string (#425)

3.7.3 - 2013-09-08

  • Added the ability to get the exception associated with a request/command when using MultiTransferException and

CommandTransferException.

  • Setting additionalParameters of a response to false is now honored when parsing responses with a service description
  • Schemas are only injected into response models when explicitly configured.
  • No longer guessing Content-Type based on the path of a request. Content-Type is now only guessed based on the path of

an EntityBody.

  • Bug fix: ChunkedIterator can now properly chunk a \Traversable as well as an \Iterator.
  • Bug fix: FilterIterator now relies on \Iterator instead of \Traversable.
  • Bug fix: Gracefully handling malformed responses in RequestMediator::writeResponseBody()
  • Bug fix: Replaced call to canCache with canCacheRequest in the CallbackCanCacheStrategy of the CachePlugin
  • Bug fix: Visiting XML attributes first before visiting XML children when serializing requests
  • Bug fix: Properly parsing headers that contain commas contained in quotes
  • Bug fix: mimetype guessing based on a filename is now case-insensitive

3.7.2 - 2013-08-02

  • Bug fix: Properly URL encoding paths when using the PHP-only version of the UriTemplate expander

See https://github.com/guzzle/guzzle/issues/371

  • Bug fix: Cookie domains are now matched correctly according to RFC 6265

See https://github.com/guzzle/guzzle/issues/377

  • Bug fix: GET parameters are now used when calculating an OAuth signature
  • Bug fix: Fixed an issue with cache revalidation where the If-None-Match header was being double quoted
  • Guzzle\Common\AbstractHasDispatcher::dispatch() now returns the event that was dispatched
  • Guzzle\Http\QueryString::factory() now guesses the most appropriate query aggregator to used based on the input.

See https://github.com/guzzle/guzzle/issues/379

  • Added a way to add custom domain objects to service description parsing using the operation.parse_class event. See

https://github.com/guzzle/guzzle/pull/380

  • cURL multi cleanup and optimizations

3.7.1 - 2013-07-05

  • Bug fix: Setting default options on a client now works
  • Bug fix: Setting options on HEAD requests now works. See #352
  • Bug fix: Moving stream factory before send event to before building the stream. See #353
  • Bug fix: Cookies no longer match on IP addresses per RFC 6265
  • Bug fix: Correctly parsing header parameters that are in <> and quotes
  • Added cert and ssl_key as request options
  • Host header can now diverge from the host part of a URL if the header is set manually
  • Guzzle\Service\Command\LocationVisitor\Request\XmlVisitor was rewritten to change from using SimpleXML to XMLWriter
  • OAuth parameters are only added via the plugin if they aren't already set
  • Exceptions are now thrown when a URL cannot be parsed
  • Returning false if Guzzle\Http\EntityBody::getContentMd5() fails
  • Not setting a Content-MD5 on a command if calculating the Content-MD5 fails via the CommandContentMd5Plugin

3.7.0 - 2013-06-10

  • See UPGRADING.md for more information on how to upgrade.
  • Requests now support the ability to specify an array of $options when creating a request to more easily modify a

request. You can pass a 'request.options' configuration setting to a client to apply default request options to every request created by a client (e.g. default query string variables, headers, curl options, etc.).

  • Added a static facade class that allows you to use Guzzle with static methods and mount the class to \Guzzle.

See Guzzle\Http\StaticClient::mount.

  • Added command.request_options to Guzzle\Service\Command\AbstractCommand to pass request options to requests

created by a command (e.g. custom headers, query string variables, timeout settings, etc.).

  • Stream size in Guzzle\Stream\PhpStreamRequestFactory will now be set if Content-Length is returned in the

headers of a response

  • Added Guzzle\Common\Collection::setPath($path, $value) to set a value into an array using a nested key

(e.g. $collection->setPath('foo/baz/bar', 'test'); echo $collection['foo']['bar']['bar'];)

  • ServiceBuilders now support storing and retrieving arbitrary data
  • CachePlugin can now purge all resources for a given URI
  • CachePlugin can automatically purge matching cached items when a non-idempotent request is sent to a resource
  • CachePlugin now uses the Vary header to determine if a resource is a cache hit
  • Guzzle\Http\Message\Response now implements \Serializable
  • Added Guzzle\Cache\CacheAdapterFactory::fromCache() to more easily create cache adapters
  • Guzzle\Service\ClientInterface::execute() now accepts an array, single command, or Traversable
  • Fixed a bug in Guzzle\Http\Message\Header\Link::addLink()
  • Better handling of calculating the size of a stream in Guzzle\Stream\Stream using fstat() and caching the size
  • Guzzle\Common\Exception\ExceptionCollection now creates a more readable exception message
  • Fixing BC break: Added back the MonologLogAdapter implementation rather than extending from PsrLog so that older

Symfony users can still use the old version of Monolog.

  • Fixing BC break: Added the implementation back in for Guzzle\Http\Message\AbstractMessage::getTokenizedHeader().

Now triggering an E_USER_DEPRECATED warning when used. Use $message->getHeader()->parseParams().

  • Several performance improvements to Guzzle\Common\Collection
  • Added an $options argument to the end of the following methods of Guzzle\Http\ClientInterface:

createRequest, head, delete, put, patch, post, options, prepareRequest

  • Added an $options argument to the end of Guzzle\Http\Message\Request\RequestFactoryInterface::createRequest()
  • Added an applyOptions() method to Guzzle\Http\Message\Request\RequestFactoryInterface
  • Changed Guzzle\Http\ClientInterface::get($uri = null, $headers = null, $body = null) to

Guzzle\Http\ClientInterface::get($uri = null, $headers = null, $options = array()). You can still pass in a resource, string, or EntityBody into the $options parameter to specify the download location of the response.

  • Changed Guzzle\Common\Collection::__construct($data) to no longer accepts a null value for $data but a

default array()

  • Added Guzzle\Stream\StreamInterface::isRepeatable
  • Removed `Guzzle\Http\ClientInterface::setDefaultHeaders(). Use

$client->getConfig()->setPath('request.options/headers/{header_name}', 'value'). or $client->getConfig()->setPath('request.options/headers', array('header_name' => 'value')).

  • Removed Guzzle\Http\ClientInterface::getDefaultHeaders(). Use $client->getConfig()->getPath('request.options/headers').
  • Removed Guzzle\Http\ClientInterface::expandTemplate()
  • Removed Guzzle\Http\ClientInterface::setRequestFactory()
  • Removed Guzzle\Http\ClientInterface::getCurlMulti()
  • Removed Guzzle\Http\Message\RequestInterface::canCache
  • Removed Guzzle\Http\Message\RequestInterface::setIsRedirect
  • Removed Guzzle\Http\Message\RequestInterface::isRedirect
  • Made Guzzle\Http\Client::expandTemplate and getUriTemplate protected methods.
  • You can now enable E_USER_DEPRECATED warnings to see if you are using a deprecated method by setting

Guzzle\Common\Version::$emitWarnings to true.

  • Marked Guzzle\Http\Message\Request::isResponseBodyRepeatable() as deprecated. Use

$request->getResponseBody()->isRepeatable() instead.

  • Marked Guzzle\Http\Message\Request::canCache() as deprecated. Use

Guzzle\Plugin\Cache\DefaultCanCacheStrategy->canCacheRequest() instead.

  • Marked Guzzle\Http\Message\Request::canCache() as deprecated. Use

Guzzle\Plugin\Cache\DefaultCanCacheStrategy->canCacheRequest() instead.

  • Marked Guzzle\Http\Message\Request::setIsRedirect() as deprecated. Use the HistoryPlugin instead.
  • Marked Guzzle\Http\Message\Request::isRedirect() as deprecated. Use the HistoryPlugin instead.
  • Marked Guzzle\Cache\CacheAdapterFactory::factory() as deprecated
  • Marked 'command.headers', 'command.response_body' and 'command.on_complete' as deprecated for AbstractCommand.

These will work through Guzzle 4.0

  • Marked 'request.params' for Guzzle\Http\Client as deprecated. Use [request.options][params].
  • Marked Guzzle\Service\Client::enableMagicMethods() as deprecated. Magic methods can no longer be disabled on a Guzzle\Service\Client.
  • Marked Guzzle\Service\Client::getDefaultHeaders() as deprecated. Use $client->getConfig()->getPath('request.options/headers')`.
  • Marked Guzzle\Service\Client::setDefaultHeaders() as deprecated. Use $client->getConfig()->setPath('request.options/headers/{header_name}', 'value')`.
  • Marked Guzzle\Parser\Url\UrlParser as deprecated. Just use PHP's parse_url() and percent encode your UTF-8.
  • Marked Guzzle\Common\Collection::inject() as deprecated.
  • Marked Guzzle\Plugin\CurlAuth\CurlAuthPlugin as deprecated. Use $client->getConfig()->setPath('request.options/auth', array('user', 'pass', 'Basic|Digest');
  • CacheKeyProviderInterface and DefaultCacheKeyProvider are no longer used. All of this logic is handled in a

CacheStorageInterface. These two objects and interface will be removed in a future version.

  • Always setting X-cache headers on cached responses
  • Default cache TTLs are now handled by the CacheStorageInterface of a CachePlugin
  • CacheStorageInterface::cache($key, Response $response, $ttl = null) has changed to `cache(RequestInterface

$request, Response $response);`

  • CacheStorageInterface::fetch($key) has changed to fetch(RequestInterface $request);
  • CacheStorageInterface::delete($key) has changed to delete(RequestInterface $request);
  • Added CacheStorageInterface::purge($url)
  • `DefaultRevalidation::__construct(CacheKeyProviderInterface $cacheKey, CacheStorageInterface $cache, CachePlugin

$plugin) has changed to DefaultRevalidation::__construct(CacheStorageInterface $cache, CanCacheStrategyInterface $canCache = null)`

  • Added RevalidationInterface::shouldRevalidate(RequestInterface $request, Response $response)

3.6.0 - 2013-05-29

  • ServiceDescription now implements ToArrayInterface
  • Added command.hidden_params to blacklist certain headers from being treated as additionalParameters
  • Guzzle can now correctly parse incomplete URLs
  • Mixed casing of headers are now forced to be a single consistent casing across all values for that header.
  • Messages internally use a HeaderCollection object to delegate handling case-insensitive header resolution
  • Removed the whole changedHeader() function system of messages because all header changes now go through addHeader().
  • Specific header implementations can be created for complex headers. When a message creates a header, it uses a

HeaderFactory which can map specific headers to specific header classes. There is now a Link header and CacheControl header implementation.

  • Removed from interface: Guzzle\Http\ClientInterface::setUriTemplate
  • Removed from interface: Guzzle\Http\ClientInterface::setCurlMulti()
  • Removed Guzzle\Http\Message\Request::receivedRequestHeader() and implemented this functionality in

Guzzle\Http\Curl\RequestMediator

  • Removed the optional $asString parameter from MessageInterface::getHeader(). Just cast the header to a string.
  • Removed the optional $tryChunkedTransfer option from Guzzle\Http\Message\EntityEnclosingRequestInterface
  • Removed the $asObjects argument from Guzzle\Http\Message\MessageInterface::getHeaders()
  • Removed Guzzle\Parser\ParserRegister::get(). Use getParser()
  • Removed Guzzle\Parser\ParserRegister::set(). Use registerParser().
  • All response header helper functions return a string rather than mixing Header objects and strings inconsistently
  • Removed cURL blacklist support. This is no longer necessary now that Expect, Accept, etc. are managed by Guzzle

directly via interfaces

  • Removed the injecting of a request object onto a response object. The methods to get and set a request still exist

but are a no-op until removed.

  • Most classes that used to require a Guzzle\Service\Command\CommandInterface typehint now request a

Guzzle\Service\Command\ArrayCommandInterface.

  • Added Guzzle\Http\Message\RequestInterface::startResponse() to the RequestInterface to handle injecting a response

on a request while the request is still being transferred

  • The ability to case-insensitively search for header values
  • Guzzle\Http\Message\Header::hasExactHeader
  • Guzzle\Http\Message\Header::raw. Use getAll()
  • Deprecated cache control specific methods on Guzzle\Http\Message\AbstractMessage. Use the CacheControl header object

instead.

  • Guzzle\Service\Command\CommandInterface now extends from ToArrayInterface and ArrayAccess
  • Added the ability to cast Model objects to a string to view debug information.

3.5.0 - 2013-05-13

  • Bug: Fixed a regression so that request responses are parsed only once per oncomplete event rather than multiple times
  • Bug: Better cleanup of one-time events across the board (when an event is meant to fire once, it will now remove

itself from the EventDispatcher)

  • Bug: Guzzle\Log\MessageFormatter now properly writes "total_time" and "connect_time" values
  • Bug: Cloning an EntityEnclosingRequest now clones the EntityBody too
  • Bug: Fixed an undefined index error when parsing nested JSON responses with a sentAs parameter that reference a

non-existent key

  • Bug: All __call() method arguments are now required (helps with mocking frameworks)
  • Deprecating Response::getRequest() and now using a shallow clone of a request object to remove a circular reference

to help with refcount based garbage collection of resources created by sending a request

  • Deprecating ZF1 cache and log adapters. These will be removed in the next major version.
  • Deprecating Response::getPreviousResponse() (method signature still exists, but it's deprecated). Use the

HistoryPlugin for a history.

  • Added a responseBody alias for the response_body location
  • Refactored internals to no longer rely on Response::getRequest()
  • HistoryPlugin can now be cast to a string
  • HistoryPlugin now logs transactions rather than requests and responses to more accurately keep track of the requests

and responses that are sent over the wire

  • Added getEffectiveUrl() and getRedirectCount() to Response objects

3.4.3 - 2013-04-30

  • Bug fix: Fixing bug introduced in 3.4.2 where redirect responses are duplicated on the final redirected response
  • Added a check to re-extract the temp cacert bundle from the phar before sending each request

3.4.2 - 2013-04-29

  • Bug fix: Stream objects now work correctly with "a" and "a+" modes
  • Bug fix: Removing Transfer-Encoding: chunked header when a Content-Length is present
  • Bug fix: AsyncPlugin no longer forces HEAD requests
  • Bug fix: DateTime timezones are now properly handled when using the service description schema formatter
  • Bug fix: CachePlugin now properly handles stale-if-error directives when a request to the origin server fails
  • Setting a response on a request will write to the custom request body from the response body if one is specified
  • LogPlugin now writes to php://output when STDERR is undefined
  • Added the ability to set multiple POST files for the same key in a single call
  • application/x-www-form-urlencoded POSTs now use the utf-8 charset by default
  • Added the ability to queue CurlExceptions to the MockPlugin
  • Cleaned up how manual responses are queued on requests (removed "queued_response" and now using request.before_send)
  • Configuration loading now allows remote files

3.4.1 - 2013-04-16

  • Large refactoring to how CurlMulti handles work. There is now a proxy that sits in front of a pool of CurlMulti

handles. This greatly simplifies the implementation, fixes a couple bugs, and provides a small performance boost.

  • Exceptions are now properly grouped when sending requests in parallel
  • Redirects are now properly aggregated when a multi transaction fails
  • Redirects now set the response on the original object even in the event of a failure
  • Bug fix: Model names are now properly set even when using $refs
  • Added support for PHP 5.5's CurlFile to prevent warnings with the deprecated @ syntax
  • Added support for oauth_callback in OAuth signatures
  • Added support for oauth_verifier in OAuth signatures
  • Added support to attempt to retrieve a command first literally, then ucfirst, the with inflection

3.4.0 - 2013-04-11

  • Bug fix: URLs are now resolved correctly based on https://datatracker.ietf.org/doc/html/rfc3986#section-5.2. #289
  • Bug fix: Absolute URLs with a path in a service description will now properly override the base URL. #289
  • Bug fix: Parsing a query string with a single PHP array value will now result in an array. #263
  • Bug fix: Better normalization of the User-Agent header to prevent duplicate headers. #264.
  • Bug fix: Added number type to service descriptions.
  • Bug fix: empty parameters are removed from an OAuth signature
  • Bug fix: Revalidating a cache entry prefers the Last-Modified over the Date header
  • Bug fix: Fixed "array to string" error when validating a union of types in a service description
  • Bug fix: Removed code that attempted to determine the size of a stream when data is written to the stream
  • Bug fix: Not including an oauth_token if the value is null in the OauthPlugin.
  • Bug fix: Now correctly aggregating successful requests and failed requests in CurlMulti when a redirect occurs.
  • The new default CURLOPT_TIMEOUT setting has been increased to 150 seconds so that Guzzle works on poor connections.
  • Added a feature to EntityEnclosingRequest::setBody() that will automatically set the Content-Type of the request if

the Content-Type can be determined based on the entity body or the path of the request.

  • Added the ability to overwrite configuration settings in a client when grabbing a throwaway client from a builder.
  • Added support for a PSR-3 LogAdapter.
  • Added a command.after_prepare event
  • Added oauth_callback parameter to the OauthPlugin
  • Added the ability to create a custom stream class when using a stream factory
  • Added a CachingEntityBody decorator
  • Added support for additionalParameters in service descriptions to define how custom parameters are serialized.
  • The bundled SSL certificate is now provided in the phar file and extracted when running Guzzle from a phar.
  • You can now send any EntityEnclosingRequest with POST fields or POST files and cURL will handle creating bodies
  • POST requests using a custom entity body are now treated exactly like PUT requests but with a custom cURL method. This

means that the redirect behavior of POST requests with custom bodies will not be the same as POST requests that use POST fields or files (the latter is only used when emulating a form POST in the browser).

  • Lots of cleanup to CurlHandle::factory and RequestFactory::createRequest

3.3.1 - 2013-03-10

  • Added the ability to create PHP streaming responses from HTTP requests
  • Bug fix: Running any filters when parsing response headers with service descriptions
  • Bug fix: OauthPlugin fixes to allow for multi-dimensional array signing, and sorting parameters before signing
  • Bug fix: Removed the adding of default empty arrays and false Booleans to responses in order to be consistent across

response location visitors.

  • Bug fix: Removed the possibility of creating configuration files with circular dependencies
  • RequestFactory::create() now uses the key of a POST file when setting the POST file name
  • Added xmlAllowEmpty to serialize an XML body even if no XML specific parameters are set

3.3.0 - 2013-03-03

  • A large number of performance optimizations have been made
  • Bug fix: Added 'wb' as a valid write mode for streams
  • Bug fix: Guzzle\Http\Message\Response::json() now allows scalar values to be returned
  • Bug fix: Fixed bug in Guzzle\Http\Message\Response where wrapping quotes were stripped from getEtag()
  • BC: Removed Guzzle\Http\Utils class
  • BC: Setting a service description on a client will no longer modify the client's command factories.
  • BC: Emitting IO events from a RequestMediator is now a parameter that must be set in a request's curl options using

the 'emit_io' key. This was previously set under a request's parameters using 'curl.emit_io'

  • BC: Guzzle\Stream\Stream::getWrapper() and Guzzle\Stream\Stream::getSteamType() are no longer converted to

lowercase

  • Operation parameter objects are now lazy loaded internally
  • Added ErrorResponsePlugin that can throw errors for responses defined in service description operations' errorResponses
  • Added support for instantiating responseType=class responseClass classes. Classes must implement

Guzzle\Service\Command\ResponseClassInterface

  • Added support for additionalProperties for top-level parameters in responseType=model responseClasses. These

additional properties also support locations and can be used to parse JSON responses where the outermost part of the JSON is an array

  • Added support for nested renaming of JSON models (rename sentAs to name)
  • CachePlugin
  • Added support for stale-if-error so that the CachePlugin can now serve stale content from the cache on error
  • Debug headers can now added to cached response in the CachePlugin

3.2.0 - 2013-02-14

  • CurlMulti is no longer reused globally. A new multi object is created per-client. This helps to isolate clients.
  • URLs with no path no longer contain a "/" by default
  • Guzzle\Http\QueryString does no longer manages the leading "?". This is now handled in Guzzle\Http\Url.
  • BadResponseException no longer includes the full request and response message
  • Adding setData() to Guzzle\Service\Description\ServiceDescriptionInterface
  • Adding getResponseBody() to Guzzle\Http\Message\RequestInterface
  • Various updates to classes to use ServiceDescriptionInterface type hints rather than ServiceDescription
  • Header values can now be normalized into distinct values when multiple headers are combined with a comma separated list
  • xmlEncoding can now be customized for the XML declaration of a XML service description operation
  • Guzzle\Http\QueryString now uses Guzzle\Http\QueryAggregator\QueryAggregatorInterface objects to add custom value

aggregation and no longer uses callbacks

  • The URL encoding implementation of Guzzle\Http\QueryString can now be customized
  • Bug fix: Filters were not always invoked for array service description parameters
  • Bug fix: Redirects now use a target response body rather than a temporary response body
  • Bug fix: The default exponential backoff BackoffPlugin was not giving when the request threshold was exceeded
  • Bug fix: Guzzle now takes the first found value when grabbing Cache-Control directives

3.1.2 - 2013-01-27

  • Refactored how operation responses are parsed. Visitors now include a before() method responsible for parsing the

response body. For example, the XmlVisitor now parses the XML response into an array in the before() method.

  • Fixed an issue where cURL would not automatically decompress responses when the Accept-Encoding header was sent
  • CURLOPT_SSL_VERIFYHOST is never set to 1 because it is deprecated (see 5e0ff2ef20f839e19d1eeb298f90ba3598784444)
  • Fixed a bug where redirect responses were not chained correctly using getPreviousResponse()
  • Setting default headers on a client after setting the user-agent will not erase the user-agent setting

3.1.1 - 2013-01-20

  • Adding wildcard support to Guzzle\Common\Collection::getPath()
  • Adding alias support to ServiceBuilder configs
  • Adding Guzzle\Service\Resource\CompositeResourceIteratorFactory and cleaning up factory interface

3.1.0 - 2013-01-12

  • BC: CurlException now extends from RequestException rather than BadResponseException
  • BC: Renamed Guzzle\Plugin\Cache\CanCacheStrategyInterface::canCache() to canCacheRequest() and added CanCacheResponse()
  • Added getData to ServiceDescriptionInterface
  • Added context array to RequestInterface::setState()
  • Bug: Removing hard dependency on the BackoffPlugin from Guzzle\Http
  • Bug: Adding required content-type when JSON request visitor adds JSON to a command
  • Bug: Fixing the serialization of a service description with custom data
  • Made it easier to deal with exceptions thrown when transferring commands or requests in parallel by providing

an array of successful and failed responses

  • Moved getPath from Guzzle\Service\Resource\Model to Guzzle\Common\Collection
  • Added Guzzle\Http\IoEmittingEntityBody
  • Moved command filtration from validators to location visitors
  • Added extends attributes to service description parameters
  • Added getModels to ServiceDescriptionInterface

3.0.7 - 2012-12-19

  • Fixing phar detection when forcing a cacert to system if null or true
  • Allowing filename to be passed to Guzzle\Http\Message\Request::setResponseBody()
  • Cleaning up Guzzle\Common\Collection::inject method
  • Adding a response_body location to service descriptions

3.0.6 - 2012-12-09

  • CurlMulti performance improvements
  • Adding setErrorResponses() to Operation
  • composer.json tweaks

3.0.5 - 2012-11-18

  • Bug: Fixing an infinite recursion bug caused from revalidating with the CachePlugin
  • Bug: Response body can now be a string containing "0"
  • Bug: Using Guzzle inside of a phar uses system by default but now allows for a custom cacert
  • Bug: QueryString::fromString now properly parses query string parameters that contain equal signs
  • Added support for XML attributes in service description responses
  • DefaultRequestSerializer now supports array URI parameter values for URI template expansion
  • Added better mimetype guessing to requests and post files

3.0.4 - 2012-11-11

  • Bug: Fixed a bug when adding multiple cookies to a request to use the correct glue value
  • Bug: Cookies can now be added that have a name, domain, or value set to "0"
  • Bug: Using the system cacert bundle when using the Phar
  • Added json and xml methods to Response to make it easier to parse JSON and XML response data into data structures
  • Enhanced cookie jar de-duplication
  • Added the ability to enable strict cookie jars that throw exceptions when invalid cookies are added
  • Added setStream to StreamInterface to actually make it possible to implement custom rewind behavior for entity bodies
  • Added the ability to create any sort of hash for a stream rather than just an MD5 hash

3.0.3 - 2012-11-04

  • Implementing redirects in PHP rather than cURL
  • Added PECL URI template extension and using as default parser if available
  • Bug: Fixed Content-Length parsing of Response factory
  • Adding rewind() method to entity bodies and streams. Allows for custom rewinding of non-repeatable streams.
  • Adding ToArrayInterface throughout library
  • Fixing OauthPlugin to create unique nonce values per request

3.0.2 - 2012-10-25

  • Magic methods are enabled by default on clients
  • Magic methods return the result of a command
  • Service clients no longer require a base_url option in the factory
  • Bug: Fixed an issue with URI templates where null template variables were being expanded

3.0.1 - 2012-10-22

  • Models can now be used like regular collection objects by calling filter, map, etc.
  • Models no longer require a Parameter structure or initial data in the constructor
  • Added a custom AppendIterator to get around a PHP bug with the \AppendIterator

3.0.0 - 2012-10-15

  • Rewrote service description format to be based on Swagger
  • Now based on JSON schema
  • Added nested input structures and nested response models
  • Support for JSON and XML input and output models
  • Renamed commands to operations
  • Removed dot class notation
  • Removed custom types
  • Broke the project into smaller top-level namespaces to be more component friendly
  • Removed support for XML configs and descriptions. Use arrays or JSON files.
  • Removed the Validation component and Inspector
  • Moved all cookie code to Guzzle\Plugin\Cookie
  • Magic methods on a Guzzle\Service\Client now return the command un-executed.
  • Calling getResult() or getResponse() on a command will lazily execute the command if needed.
  • Now shipping with cURL's CA certs and using it by default
  • Added previousResponse() method to response objects
  • No longer sending Accept and Accept-Encoding headers on every request
  • Only sending an Expect header by default when a payload is greater than 1MB
  • Added/moved client options:
  • curl.blacklist to curl.option.blacklist
  • Added ssl.certificate_authority
  • Added a Guzzle\Iterator component
  • Moved plugins from Guzzle\Http\Plugin to Guzzle\Plugin
  • Added a more robust backoff retry strategy (replaced the ExponentialBackoffPlugin)
  • Added a more robust caching plugin
  • Added setBody to response objects
  • Updating LogPlugin to use a more flexible MessageFormatter
  • Added a completely revamped build process
  • Cleaning up Collection class and removing default values from the get method
  • Fixed ZF2 cache adapters

2.8.8 - 2012-10-15

  • Bug: Fixed a cookie issue that caused dot prefixed domains to not match where popular browsers did

2.8.7 - 2012-09-30

  • Bug: Fixed config file aliases for JSON includes
  • Bug: Fixed cookie bug on a request object by using CookieParser to parse cookies on requests
  • Bug: Removing the path to a file when sending a Content-Disposition header on a POST upload
  • Bug: Hardening request and response parsing to account for missing parts
  • Bug: Fixed PEAR packaging
  • Bug: Fixed Request::getInfo
  • Bug: Fixed cases where CURLM_CALL_MULTI_PERFORM return codes were causing curl transactions to fail
  • Adding the ability for the namespace Iterator factory to look in multiple directories
  • Added more getters/setters/removers from service descriptions
  • Added the ability to remove POST fields from OAuth signatures
  • OAuth plugin now supports 2-legged OAuth

2.8.6 - 2012-09-05

  • Added the ability to modify and build service descriptions
  • Added the use of visitors to apply parameters to locations in service descriptions using the dynamic command
  • Added a json parameter location
  • Now allowing dot notation for classes in the CacheAdapterFactory
  • Using the union of two arrays rather than an array_merge when extending service builder services and service params
  • Ensuring that a service is a string before doing strpos() checks on it when substituting services for references

in service builder config files.

  • Services defined in two different config files that include one another will by default replace the previously

defined service, but you can now create services that extend themselves and merge their settings over the previous

  • The JsonLoader now supports aliasing filenames with different filenames. This allows you to alias something like

'_default' with a default JSON configuration file.

2.8.5 - 2012-08-29

  • Bug: Suppressed empty arrays from URI templates
  • Bug: Added the missing $options argument from ServiceDescription::factory to enable caching
  • Added support for HTTP responses that do not contain a reason phrase in the start-line
  • AbstractCommand commands are now invokable
  • Added a way to get the data used when signing an Oauth request before a request is sent

2.8.4 - 2012-08-15

  • Bug: Custom delay time calculations are no longer ignored in the ExponentialBackoffPlugin
  • Added the ability to transfer entity bodies as a string rather than streamed. This gets around curl error 65. Set body_as_string in a request's curl options to enable.
  • Added a StreamInterface, EntityBodyInterface, and added ftell() to Guzzle\Common\Stream
  • Added an AbstractEntityBodyDecorator and a ReadLimitEntityBody decorator to transfer only a subset of a decorated stream
  • Stream and EntityBody objects will now return the file position to the previous position after a read required operation (e.g. getContentMd5())
  • Added additional response status codes
  • Removed SSL information from the default User-Agent header
  • DELETE requests can now send an entity body
  • Added an EventDispatcher to the ExponentialBackoffPlugin and added an ExponentialBackoffLogger to log backoff retries
  • Added the ability of the MockPlugin to consume mocked request bodies
  • LogPlugin now exposes request and response objects in the extras array

2.8.3 - 2012-07-30

  • Bug: Fixed a case where empty POST requests were sent as GET requests
  • Bug: Fixed a bug in ExponentialBackoffPlugin that caused fatal errors when retrying an EntityEnclosingRequest that does not have a body
  • Bug: Setting the response body of a request to null after completing a request, not when setting the state of a request to new
  • Added multiple inheritance to service description commands
  • Added an ApiCommandInterface and added getParamNames() and hasParam()
  • Removed the default 2mb size cutoff from the Md5ValidatorPlugin so that it now defaults to validating everything
  • Changed CurlMulti::perform to pass a smaller timeout to CurlMulti::executeHandles

2.8.2 - 2012-07-24

  • Bug: Query string values set to 0 are no longer dropped from the query string
  • Bug: A Collection object is no longer created each time a call is made to Guzzle\Service\Command\AbstractCommand::getRequestHeaders()
  • Bug: + is now treated as an encoded space when parsing query strings
  • QueryString and Collection performance improvements
  • Allowing dot notation for class paths in filters attribute of a service descriptions

2.8.1 - 2012-07-16

  • Loosening Event Dispatcher dependency
  • POST redirects can now be customized using CURLOPT_POSTREDIR

2.8.0 - 2012-07-15

  • BC: Guzzle\Http\Query
  • Query strings with empty variables will always show an equal sign unless the variable is set to QueryString::BLANK (e.g. ?acl= vs ?acl)
  • Changed isEncodingValues() and isEncodingFields() to isUrlEncoding()
  • Changed setEncodeValues(bool) and setEncodeFields(bool) to useUrlEncoding(bool)
  • Changed the aggregation functions of QueryString to be static methods
  • Can now use fromString() with querystrings that have a leading ?
  • cURL configuration values can be specified in service descriptions using curl. prefixed parameters
  • Content-Length is set to 0 before emitting the request.before_send event when sending an empty request body
  • Cookies are no longer URL decoded by default
  • Bug: URI template variables set to null are no longer expanded

2.7.2 - 2012-07-02

  • BC: Moving things to get ready for subtree splits. Moving Inflection into Common. Moving Guzzle\Http\Parser to Guzzle\Parser.
  • BC: Removing Guzzle\Common\Batch\Batch::count() and replacing it with isEmpty()
  • CachePlugin now allows for a custom request parameter function to check if a request can be cached
  • Bug fix: CachePlugin now only caches GET and HEAD requests by default
  • Bug fix: Using header glue when transferring headers over the wire
  • Allowing deeply nested arrays for composite variables in URI templates
  • Batch divisors can now return iterators or arrays

2.7.1 - 2012-06-26

  • Minor patch to update version number in UA string
  • Updating build process

2.7.0 - 2012-06-25

  • BC: Inflection classes moved to Guzzle\Inflection. No longer static methods. Can now inject custom inflectors into classes.
  • BC: Removed magic setX methods from commands
  • BC: Magic methods mapped to service description commands are now inflected in the command factory rather than the client __call() method
  • Verbose cURL options are no longer enabled by default. Set curl.debug to true on a client to enable.
  • Bug: Now allowing colons in a response start-line (e.g. HTTP/1.1 503 Service Unavailable: Back-end server is at capacity)
  • Guzzle\Service\Resource\ResourceIteratorApplyBatched now internally uses the Guzzle\Common\Batch namespace
  • Added Guzzle\Service\Plugin namespace and a PluginCollectionPlugin
  • Added the ability to set POST fields and files in a service description
  • Guzzle\Http\EntityBody::factory() now accepts objects with a __toString() method
  • Adding a command.before_prepare event to clients
  • Added BatchClosureTransfer and BatchClosureDivisor
  • BatchTransferException now includes references to the batch divisor and transfer strategies
  • Fixed some tests so that they pass more reliably
  • Added Guzzle\Common\Log\ArrayLogAdapter

2.6.6 - 2012-06-10

  • BC: Removing Guzzle\Http\Plugin\BatchQueuePlugin
  • BC: Removing Guzzle\Service\Command\CommandSet
  • Adding generic batching system (replaces the batch queue plugin and command set)
  • Updating ZF cache and log adapters and now using ZF's composer repository
  • Bug: Setting the name of each ApiParam when creating through an ApiCommand
  • Adding result_type, result_doc, deprecated, and doc_url to service descriptions
  • Bug: Changed the default cookie header casing back to 'Cookie'

2.6.5 - 2012-06-03

  • BC: Renaming Guzzle\Http\Message\RequestInterface::getResourceUri() to getResource()
  • BC: Removing unused AUTH_BASIC and AUTH_DIGEST constants from
  • BC: Guzzle\Http\Cookie is now used to manage Set-Cookie data, not Cookie data
  • BC: Renaming methods in the CookieJarInterface
  • Moving almost all cookie logic out of the CookiePlugin and into the Cookie or CookieJar implementations
  • Making the default glue for HTTP headers ';' instead of ','
  • Adding a removeValue to Guzzle\Http\Message\Header
  • Adding getCookies() to request interface.
  • Making it easier to add event subscribers to HasDispatcherInterface classes. Can now directly call addSubscriber()

2.6.4 - 2012-05-30

  • BC: Cleaning up how POST files are stored in EntityEnclosingRequest objects. Adding PostFile class.
  • BC: Moving ApiCommand specific functionality from the Inspector and on to the ApiCommand
  • Bug: Fixing magic method command calls on clients
  • Bug: Email constraint only validates strings
  • Bug: Aggregate POST fields when POST files are present in curl handle
  • Bug: Fixing default User-Agent header
  • Bug: Only appending or prepending parameters in commands if they are specified
  • Bug: Not requiring response reason phrases or status codes to match a predefined list of codes
  • Allowing the use of dot notation for class namespaces when using instance_of constraint
  • Added any_match validation constraint
  • Added an AsyncPlugin
  • Passing request object to the calculateWait method of the ExponentialBackoffPlugin
  • Allowing the result of a command object to be changed
  • Parsing location and type sub values when instantiating a service description rather than over and over at runtime

2.6.3 - 2012-05-23

  • [BC] Guzzle\Common\FromConfigInterface no longer requires any config options.
  • [BC] Refactoring how POST files are stored on an EntityEnclosingRequest. They are now separate from POST fields.
  • You can now use an array of data when creating PUT request bodies in the request factory.
  • Removing the requirement that HTTPS requests needed a Cache-Control: public directive to be cacheable.
  • [Http] Adding support for Content-Type in multipart POST uploads per upload
  • [Http] Added support for uploading multiple files using the same name (foo[0], foo[1])
  • Adding more POST data operations for easier manipulation of POST data.
  • You can now set empty POST fields.
  • The body of a request is only shown on EntityEnclosingRequest objects that do not use POST files.
  • Split the Guzzle\Service\Inspector::validateConfig method into two methods. One to initialize when a command is created, and one to validate.
  • CS updates

2.6.2 - 2012-05-19

  • [Http] Better handling of nested scope requests in CurlMulti. Requests are now always prepares in the send() method rather than the addRequest() method.

2.6.1 - 2012-05-19

  • [BC] Removing 'path' support in service descriptions. Use 'uri'.
  • [BC] Guzzle\Service\Inspector::parseDocBlock is now protected. Adding getApiParamsForClass() with cache.
  • [BC] Removing Guzzle\Common\NullObject. Use https://github.com/mtdowling/NullObject if you need it.
  • [BC] Removing Guzzle\Common\XmlElement.
  • All commands, both dynamic and concrete, have ApiCommand objects.
  • Adding a fix for CurlMulti so that if all of the connections encounter some sort of curl error, then the loop exits.
  • Adding checks to EntityEnclosingRequest so that empty POST files and fields are ignored.
  • Making the method signature of Guzzle\Service\Builder\ServiceBuilder::factory more flexible.

2.6.0 - 2012-05-15

  • [BC] Moving Guzzle\Service\Builder to Guzzle\Service\Builder\ServiceBuilder
  • [BC] Executing a Command returns the result of the command rather than the command
  • [BC] Moving all HTTP parsing logic to Guzzle\Http\Parsers. Allows for faster C implementations if needed.
  • [BC] Changing the Guzzle\Http\Message\Response::setProtocol() method to accept a protocol and version in separate args.
  • [BC] Moving ResourceIterator* to Guzzle\Service\Resource
  • [BC] Completely refactored ResourceIterators to iterate over a cloned command object
  • [BC] Moved Guzzle\Http\UriTemplate to Guzzle\Http\Parser\UriTemplate\UriTemplate
  • [BC] Guzzle\Guzzle is now deprecated
  • Moving Guzzle\Common\Guzzle::inject to Guzzle\Common\Collection::inject
  • Adding Guzzle\Version class to give version information about Guzzle
  • Adding Guzzle\Http\Utils class to provide getDefaultUserAgent() and getHttpDate()
  • Adding Guzzle\Curl\CurlVersion to manage caching curl_version() data
  • ServiceDescription and ServiceBuilder are now cacheable using similar configs
  • Changing the format of XML and JSON service builder configs. Backwards compatible.
  • Cleaned up Cookie parsing
  • Trimming the default Guzzle User-Agent header
  • Adding a setOnComplete() method to Commands that is called when a command completes
  • Keeping track of requests that were mocked in the MockPlugin
  • Fixed a caching bug in the CacheAdapterFactory
  • Inspector objects can be injected into a Command object
  • Refactoring a lot of code and tests to be case insensitive when dealing with headers
  • Adding Guzzle\Http\Message\HeaderComparison for easy comparison of HTTP headers using a DSL
  • Adding the ability to set global option overrides to service builder configs
  • Adding the ability to include other service builder config files from within XML and JSON files
  • Moving the parseQuery method out of Url and on to QueryString::fromString() as a static factory method.

2.5.0 - 2012-05-08

  • Major performance improvements
  • [BC] Simplifying Guzzle\Common\Collection. Please check to see if you are using features that are now deprecated.
  • [BC] Using a custom validation system that allows a flyweight implementation for much faster validation. No longer using Symfony2 Validation component.
  • [BC] No longer supporting "{{ }}" for injecting into command or UriTemplates. Use "{}"
  • Added the ability to passed parameters to all requests created by a client
  • Added callback functionality to the ExponentialBackoffPlugin
  • Using microtime in ExponentialBackoffPlugin to allow more granular backoff strategies.
  • Rewinding request stream bodies when retrying requests
  • Exception is thrown when JSON response body cannot be decoded
  • Added configurable magic method calls to clients and commands. This is off by default.
  • Fixed a defect that added a hash to every parsed URL part
  • Fixed duplicate none generation for OauthPlugin.
  • Emitting an event each time a client is generated by a ServiceBuilder
  • Using an ApiParams object instead of a Collection for parameters of an ApiCommand
  • cache. request parameters should be renamed to params.cache.
  • Added the ability to set arbitrary curl options on requests (disable_wire, progress, etc.). See CurlHandle.
  • Added the ability to disable type validation of service descriptions
  • ServiceDescriptions and ServiceBuilders are now Serializable
Source
1# Change Log
2
3Please refer to [UPGRADING](UPGRADING.md) guide for upgrading to a major version.
4
5
6## 7.15.5 - 2026-08-24
7
8### Changed
9
10- Adjusted `guzzlehttp/psr7` version constraint to `^2.13.1`
11- Adjusted `guzzlehttp/promises` version constraint to `^2.5.3`
12
13## 7.15.4 - 2026-08-24
14
15### Added
16
17- Added support for PHP 8.6
18
19### Changed
20
21- Replace the deprecated spl_object_hash() in handler stack debug output for PHP 8.6
22
23## 7.15.3 - 2026-08-05
24
25### Changed
26
27- Adjusted `guzzlehttp/promises` version constraint to `^2.5.2`
28
29### Fixed
30
31- Fail a cURL multi handler wait with an attributable error when the transfer is no longer tracked
32- Fix `StreamHandler` resolving numeric IPv4 hosts differently from cURL handlers on macOS and Windows
33- Fix `StreamHandler` TLS peer names and proxy authorities for numeric IPv4 hosts on all platforms
34- Settle a cURL multi handler transfer displaced by a request reusing its native handle ID
35
36
37## 7.15.2 - 2026-07-26
38
39### Security
40
41- Reject non-printable-ASCII and percent-escaped URI hosts and `Host` headers (GHSA-v5mv-p594-2x33)
42- Reject request URI hosts that contain a URI authority delimiter (GHSA-v5mv-p594-2x33)
43- Reject numeric-looking URI hosts with trailing dots, read as IPv4 addresses (GHSA-v5mv-p594-2x33)
44- Treat numeric-in-any-base and percent-escaped cookie domains as exact-match-only (GHSA-f7vp-7xgx-4w4r)
45- Regenerate a derived `Host` header after client URI rewrites (GHSA-v5mv-p594-2x33)
46
47### Fixed
48
49- Preserve `RequestException` when the stream handler rejects a request before opening a stream
50
51
52## 7.15.1 - 2026-07-18
53
54### Security
55
56- Preserve host-only cookie scope and require explicit persistence markers (GHSA-wm3w-8rrp-j577)
57- Bound response cookie admission and generated `Cookie` headers (GHSA-f283-ghqc-fg79)
58- Exclude URI fragments from `Referer` headers generated for redirects (GHSA-h95v-h523-3mw8)
59
60
61## 7.15.0 - 2026-07-17
62
63### Added
64
65- Added `Multiplexing::NONE` support as a client, cURL multi handler, and conditional request option
66
67### Changed
68
69- Adjusted `guzzlehttp/psr7` version constraint to `^2.13`
70- Use locale-independent ASCII folding for all case normalization and comparison
71- Bound cURL upload reads to the declared `Content-Length`
72- Sanitize the cURL error text exposed through exception handler context
73- Fail closed when a named cURL multi connection cap cannot be applied
74- Reject the request-level `CURLOPT_SHARE` cURL option when named connection caps are configured
75- Strengthen old-libcurl SOCKS isolation for raw `CURLOPT_PRE_PROXY` and opaque share handles
76- Isolate HTTP proxy tunnels from opaque shared connection caches
77- Trigger runtime deprecations for previously deprecated functionality in 7.1.0
78
79### Deprecated
80
81- Deprecated `Utils::jsonDecode()` and `Utils::jsonEncode()` in favor of native JSON functions
82- Deprecated passing `CURLMOPT_PIPELINING` in the cURL multi handler `options` array
83- Deprecated passing `CURLOPT_PROXYHEADER` without cURL proxy header separation support
84
85### Fixed
86
87- Defer cURL requests created from multi callbacks until native execution unwinds
88- Fail synchronous waits from native cURL callbacks promptly instead of self-deadlocking
89- Guard cURL multi handle removal against progress callbacks re-entering the handler
90- Scope promise waits on the cURL multi handler to the awaited transfer
91- Strip `Content-Length` and `Transfer-Encoding` when redirects discard the request body
92- Stop re-applying the `delay` request option to followed redirects
93
94
95## 7.14.2 - 2026-07-14
96
97### Security
98
99- Prevent first-class and proxy URL credentials from reaching origins (GHSA-94pj-82f3-465w)
100
101
102## 7.14.1 - 2026-07-13
103
104### Changed
105
106- Adjusted `guzzlehttp/psr7` version constraint to `^2.12.5`
107
108### Fixed
109
110- Fail closed when a proxy tunnel isolation cURL option cannot be applied
111- Normalize Stringable proxy credential values before computing connection-reuse section signatures
112- Restore conservative credential redaction for unparseable proxies with multiple `@` separators
113- Redact request URI credentials from the stream handler connection error message
114- Reject enabled response streaming (`stream => true`) on cap-configured stream handlers
115- Distinguish CurlMultiHandler and StreamHandler outcomes in connection-cap custom-handler guidance
116- Reject raw cURL options that conflict with explicit multiplexing guarantees
117- Stop explicit multiplexing conflict checks faulting on non-array cURL multi `options` values
118- Reject required multiplexing when the final `CURLOPT_HTTPAUTH` mask permits NTLM
119- Require an integer `CURLMOPT_PIPELINING` when combined with explicit multiplexing
120- Check the required multiplexing cleartext proxy rule against the final cURL configuration
121- Bound cURL multi handler blocking selects by the earliest pending request delay
122- Stop synchronous cURL multi handler waits blocking on other transfers once the target has settled
123- Stop cURL multi completion processing double-settling promises canceled from completion callbacks
124- Run ready promise queue tasks before sleeping for delayed cURL multi requests
125- Avoid integer overflow in cURL multi delay timing on 32-bit platforms
126- Roll back failed cURL multi handle attachment instead of leaving requests pending
127- Release the cURL easy handle when the `on_stats` callback throws
128- Normalize response trailer field names to lowercase with values in wire order
129- Retain response trailers only when an `on_trailers` callback is configured
130- Validate the `on_trailers` callback before starting a cURL transfer
131- Reject the `on_trailers` request option on the stream handler, which cannot observe trailers
132- Match cookies, proxy schemes, auth types, and header names with locale-independent ASCII folding
133- Reject proxy option values that Guzzle cannot classify identically to ext-curl
134
135
136## 7.14.0 - 2026-07-08
137
138### Added
139
140- Added the `on_trailers` request option to expose parsed HTTP response trailers
141- Added the `multiplex` request option with `Multiplexing::*` modes to control or require HTTP/2 multiplexing
142- Added rejection of explicit `multiplex` requests when `CURLMOPT_PIPELINING` disables multiplexing
143- Added the `max_host_connections` and `max_total_connections` client and cURL multi handler options
144
145### Changed
146
147- Redirects that discard the request body no longer require it to be rewindable
148- Synchronous cURL multi handler requests no longer wait for other queued transfers
149- Section SOCKS proxy connections by credentials on libcurl before 7.69.0
150- Reject request-level `CURLOPT_SHARE` when combined with authenticated SOCKS proxy configuration
151- Redact proxy userinfo containing raw control bytes in cURL errors
152- Check linked curl/libcurl NTLM support before applying NTLM auth
153- Clarify that NTLM is deprecated by both Guzzle and curl/libcurl
154- Remove deprecation for the raw cURL `CURLOPT_CERTINFO` option
155- Warn when a cURL multi option cannot be applied
156
157### Deprecated
158
159- Deprecate the raw `CURLOPT_PIPEWAIT` cURL option in favour of the `multiplex` request option
160- Deprecate unknown handler constructor options
161- Deprecate invalid `select_timeout` cURL multi handler option values
162- Deprecate raw cURL multi connection cap options in favour of the named options
163
164
165## 7.13.3 - 2026-07-08
166
167### Changed
168
169- Adjusted `guzzlehttp/promises` version constraint to `^2.5.1`
170- Adjusted `guzzlehttp/psr7` version constraint to `^2.12.4`
171- Pass explicit trim characters ahead of the PHP 8.6 trim default change
172
173### Fixed
174
175- Stop matching cookie domains against hosts with a trailing newline
176- Reject HTTP status codes and certificate type extensions with a trailing newline
177- Treat PCRE engine failures as invalid cookie names during cookie validation
178- Report PCRE engine failures when formatting log messages
179- Report PCRE engine failures when splitting `no_proxy` values
180
181
182## 7.13.2 - 2026-07-05
183
184### Fixed
185
186- Stop the cURL multi handler busy-waiting on request delays shorter than one second
187- Stop cURL HEAD requests with request bodies hanging on responses that declare a content length
188- The cURL handler no longer transmits request bodies on HEAD requests
189- Preserve response headers when a response includes HTTP trailers
190- Harden cURL response header block detection when HTTP trailers are received
191- Corrected the PSR-7 class names in the Pool iterator exception
192- Redirect body rewind failures no longer leak a bare `RuntimeException`
193
194
195## 7.13.1 - 2026-06-29
196
197### Fixed
198
199- Allow middleware to rewrite partial URIs before transports validate them
200
201
202## 7.13.0 - 2026-06-29
203
204### Added
205
206- Added the `crypto_method_max` request option to cap the maximum TLS protocol version
207- Added HTTP QUERY redirect support, preserving method and body on 301 and 302
208
209### Changed
210
211- Section proxy tunnel connection reuse by credential so distinct credentials never share a tunnel
212- Isolate concurrent foreign cURL proxy tunnels added while another owner's tunnel is active
213- Route credentialed HTTP(S) proxy Proxy-Authorization headers through cURL proxy header handling
214- Reject request-level `CURLOPT_SHARE` when combined with authenticated HTTP/HTTPS proxy tunnel configuration
215- Remove deprecation for raw cURL `CURLOPT_PREREQFUNCTION` callbacks when defined by PHP cURL
216- Route TLS 1.2 `crypto_method` requests to the stream handler when cURL cannot select TLS 1.2
217- Reject final request URIs missing a scheme or host before transfer
218
219### Deprecated
220
221- Deprecate invalid protocols, force_ip_resolve, delay, cookies, and allow_redirects values
222
223
224## 7.12.3 - 2026-06-23
225
226### Changed
227
228- Adjusted `guzzlehttp/psr7` version constraint to `^2.12.3`
229
230### Security
231
232- Treat IP and numeric cookie domains as exact-match-only (GHSA-g446-98w2-8p5w)
233
234
235## 7.12.2 - 2026-06-23
236
237### Fixed
238
239- Clamp out-of-range `Max-Age` so a very large value no longer overflows to an already-expired timestamp
240- Use strict comparison in `CookieJar` conflict resolution so distinct numeric-string names don't overwrite
241- Store a cookie whose `Domain` has a trailing dot on the origin host instead of silently discarding it
242- Fix `StreamHandler` hard-failing on bracketed IPv6 literal hosts when `force_ip_resolve` is set
243- Use strict cookie `Path` comparison so `CookieJar::clear()` with a numeric path keeps a distinct-path cookie
244- Fixed cookie handling for falsey `Domain`, `Max-Age`, path, and name values
245- Fixed `decode_content` handling for falsey string values
246- Fixed deprecated request option values reaching built-in handlers before normalization
247
248
249## 7.12.1 - 2026-06-18
250
251### Changed
252
253- Adjusted `guzzlehttp/psr7` version constraint to `^2.12.1`
254
255### Fixed
256
257- Reject proxy URLs with a malformed scheme in the cURL handlers instead of letting libcurl mishandle them
258
259### Security
260
261- Reject HTTPS proxies when the installed libcurl lacks HTTPS-proxy support (GHSA-wpwq-4j6v-78m3)
262- Reject dot-only cookie `Domain` attributes as match-all (GHSA-cwxw-98qj-8qjx)
263
264
265## 7.12.0 - 2026-06-16
266
267### Added
268
269- Added `RequestOptions` constants for `curl`, `retries`, and `stream_context`
270
271### Changed
272
273- Adjusted `guzzlehttp/psr7` version constraint to `^2.12`
274- Constrain cURL transport sharing to safe libcurl DNS and SSL session support
275- Resolve proxy environment variables in the cURL handlers; libcurl no longer reads the environment itself
276- Ignore proxy environment variables when the `proxy` request option makes a decision
277- Disable proxy environment variables on Windows SAPIs other than CLI (httpoxy hardening)
278- Redact proxy credentials from cURL handler error messages, following `Psr7\Utils::redactUserInfo()`
279- Normalize no-proxy domain and IP literal matching across the cURL and stream handlers
280
281### Deprecated
282
283- Deprecated the request-level `handler` option, which will be ignored in 8.0
284- Deprecated raw cURL request options outside the built-in cURL handlers' allow-list
285- Deprecated the `CURLOPT_PROXYTYPE` cURL request option; set the proxy type via a scheme-prefixed proxy URL
286- Deprecated PHP stream context options outside the built-in stream handler allow-list
287- Deprecated passing `ntlm` as a built-in `auth` type
288- Deprecated `Utils::describeType()`
289- Deprecated non-finite floats in the `query` and `form_params` options; 8.0 rejects them
290- Deprecated non-string scalar values in the `body` option; 8.0 rejects them
291
292### Fixed
293
294- Fix cURL TLS and HTTP/2 capability detection using libcurl feature checks
295- Fix proxy `no` list matches being re-proxied through environment-configured proxies by libcurl
296- Fix `no` list and `NO_PROXY` matching to support IP CIDR ranges, matching libcurl
297- Fix the stream handler not applying scheme-less proxies and their credentials
298
299
300## 7.11.2 - 2026-06-12
301
302### Fixed
303
304- Fixed non-finite float values emitting coercion warnings on PHP 8.5
305
306
307## 7.11.1 - 2026-06-07
308
309### Fixed
310
311- Ignore request-level `transport_sharing`, matching other unknown request options
312
313
314## 7.11.0 - 2026-06-02
315
316### Added
317
318- Added support for providing the `proxy` request option's `no` value as a comma-delimited string
319- Added the `protocols` request option to restrict allowed URI schemes for request transfers
320- Added `cert_type` and `ssl_key_type` request options for TLS certificate and private-key file types
321- Added PHP stream handler support for the `ssl_key` request option
322- Added transport sharing via the `transport_sharing` client and cURL handler options
323
324### Changed
325
326- Adjusted `guzzlehttp/promises` version constraint to `^2.5`
327- Adjusted `guzzlehttp/psr7` version constraint to `^2.11`
328- Allowed domainless `SetCookie` instances to be stored without wildcard request matching
329- Changed no-proxy matching to respect request ports for host-and-port rules
330- Prevented `CurlMultiHandler` destructors from throwing during cleanup
331- Improved invalid response handling across handlers
332
333### Deprecated
334
335- Deprecated non-iterable `Pool` request collections, which will be rejected in 8.0
336- Deprecated non-uppercase easy request methods; 8.0 preserves method casing
337- Deprecated non-string `headers` request option values, which will be rejected in 8.0
338- Deprecated empty `headers` request option value arrays, which will be rejected in 8.0
339- Deprecated empty and malformed request protocol versions, which will be rejected in 8.0
340- Deprecated conflicting raw cURL request options, including `CURLOPT_SHARE`, which will be rejected in 8.0
341- Deprecated scalar-coerced `idn_conversion` request option values, which will be rejected in 8.0
342- Deprecated invalid documented request option value types, which will be rejected in 8.0
343- Deprecated selected request options ignored by incompatible built-in handlers, which will be rejected in 8.0
344- Deprecated `RequestException::wrapException()`, which will be removed in 8.0
345- Deprecated `RetryMiddleware::exponentialDelay()`, which will be removed in 8.0
346
347
348## 7.10.6 - 2026-06-01
349
350### Fixed
351
352- `CurlMultiHandler` now rejects the promise when `CurlFactory::finish()` throws, preserving sibling transfers
353- `SetCookie` now normalizes unparseable `Expires` values to `null` instead of `false`
354- Fix stream handler decoded `gzip`/`deflate` truncation by dropping invalid `Content-Length`
355
356
357## 7.10.5 - 2026-05-27
358
359### Fixed
360
361- Defer cURL multi cancellation cleanup until after progress callbacks return
362- Classify additional stream handler connection failures as `ConnectException`
363
364
365## 7.10.4 - 2026-05-22
366
367### Fixed
368
369- Fix IPv6 literal matching in no-proxy rules
370- Handle cURL multi completion messages without handles after cancelled transfers
371- Fix magic client request methods such as `options()` to uppercase inferred HTTP methods
372
373
374## 7.10.3 - 2026-05-20
375
376### Fixed
377
378- Fail clearly when an HTTP response header line is invalid
379- Remove middleware by name when the name is also a callable string
380- Treat empty request protocol versions as HTTP/1.1
381
382
383## 7.10.2 - 2026-05-20
384
385### Fixed
386
387- Normalize HTTP version request options before applying them to PSR-7 requests
388- Use string values for headers generated by request preparation and response decoding
389
390
391## 7.10.1 - 2026-05-19
392
393### Fixed
394
395- Fail clearly when cURL options cannot be applied
396- Fail clearly when the certificate option is malformed
397- Fail clearly when JSON decode depth is invalid
398- Fail clearly when session cookie data is malformed
399- Fail clearly when the stream progress option is not callable
400- Prevent response creation failures from exposing stale cURL responses
401
402
403## 7.10.0 - 2025-08-23
404
405### Added
406
407- Support for PHP 8.5
408
409### Changed
410
411- Adjusted `guzzlehttp/promises` version constraint to `^2.3`
412- Adjusted `guzzlehttp/psr7` version constraint to `^2.8`
413
414
415## 7.9.3 - 2025-03-27
416
417### Changed
418
419- Remove explicit content-length header for GET requests
420- Improve compatibility with bad servers for boolean cookie values
421
422
423## 7.9.2 - 2024-07-24
424
425### Fixed
426
427- Adjusted handler selection to use cURL if its version is 7.21.2 or higher, rather than 7.34.0
428
429
430## 7.9.1 - 2024-07-19
431
432### Fixed
433
434- Fix TLS 1.3 check for HTTP/2 requests
435
436
437## 7.9.0 - 2024-07-18
438
439### Changed
440
441- Improve protocol version checks to provide feedback around unsupported protocols
442- Only select the cURL handler by default if 7.34.0 or higher is linked
443- Improved `CurlMultiHandler` to avoid busy wait if possible
444- Dropped support for EOL `guzzlehttp/psr7` v1
445- Improved URI user info redaction in errors
446
447## 7.8.2 - 2024-07-18
448
449### Added
450
451- Support for PHP 8.4
452
453
454## 7.8.1 - 2023-12-03
455
456### Changed
457
458- Updated links in docs to their canonical versions
459- Replaced `call_user_func*` with native calls
460
461
462## 7.8.0 - 2023-08-27
463
464### Added
465
466- Support for PHP 8.3
467- Added automatic closing of handles on `CurlFactory` object destruction
468
469
470## 7.7.1 - 2023-08-27
471
472### Changed
473
474- Remove the need for `AllowDynamicProperties` in `CurlMultiHandler`
475
476
477## 7.7.0 - 2023-05-21
478
479### Added
480
481- Support `guzzlehttp/promises` v2
482
483
484## 7.6.1 - 2023-05-15
485
486### Fixed
487
488- Fix `SetCookie::fromString` MaxAge deprecation warning and skip invalid MaxAge values
489
490
491## 7.6.0 - 2023-05-14
492
493### Added
494
495- Support for setting the minimum TLS version in a unified way
496- Apply on request the version set in options parameters
497
498
499## 7.5.2 - 2023-05-14
500
501### Fixed
502
503- Fixed set cookie constructor validation
504- Fixed handling of files with `'0'` body
505
506### Changed
507
508- Corrected docs and default connect timeout value to 300 seconds
509
510
511## 7.5.1 - 2023-04-17
512
513### Fixed
514
515- Fixed `NO_PROXY` settings so that setting the `proxy` option to `no` overrides the env variable
516
517### Changed
518
519- Adjusted `guzzlehttp/psr7` version constraint to `^1.9.1 || ^2.4.5`
520
521
522## 7.5.0 - 2022-08-28
523
524### Added
525
526- Support PHP 8.2
527- Add request to delay closure params
528
529
530## 7.4.5 - 2022-06-20
531
532### Fixed
533
534* Fix change in port should be considered a change in origin
535* Fix `CURLOPT_HTTPAUTH` option not cleared on change of origin
536
537
538## 7.4.4 - 2022-06-09
539
540### Fixed
541
542* Fix failure to strip Authorization header on HTTP downgrade
543* Fix failure to strip the Cookie header on change in host or HTTP downgrade
544
545
546## 7.4.3 - 2022-05-25
547
548### Fixed
549
550* Fix cross-domain cookie leakage
551
552
553## 7.4.2 - 2022-03-20
554
555### Fixed
556
557- Remove curl auth on cross-domain redirects to align with the Authorization HTTP header
558- Reject non-HTTP schemes in StreamHandler
559- Set a default ssl.peer_name context in StreamHandler to allow `force_ip_resolve`
560
561
562## 7.4.1 - 2021-12-06
563
564### Changed
565
566- Replaced implicit URI to string coercion [#2946](https://github.com/guzzle/guzzle/pull/2946)
567- Allow `symfony/deprecation-contracts` version 3 [#2961](https://github.com/guzzle/guzzle/pull/2961)
568
569### Fixed
570
571- Only close curl handle if it's done [#2950](https://github.com/guzzle/guzzle/pull/2950)
572
573
574## 7.4.0 - 2021-10-18
575
576### Added
577
578- Support PHP 8.1 [#2929](https://github.com/guzzle/guzzle/pull/2929), [#2939](https://github.com/guzzle/guzzle/pull/2939)
579- Support `psr/log` version 2 and 3 [#2943](https://github.com/guzzle/guzzle/pull/2943)
580
581### Fixed
582
583- Make sure we always call `restore_error_handler()` [#2915](https://github.com/guzzle/guzzle/pull/2915)
584- Fix progress parameter type compatibility between the cURL and stream handlers [#2936](https://github.com/guzzle/guzzle/pull/2936)
585- Throw `InvalidArgumentException` when an incorrect `headers` array is provided [#2916](https://github.com/guzzle/guzzle/pull/2916), [#2942](https://github.com/guzzle/guzzle/pull/2942)
586
587### Changed
588
589- Be more strict with types [#2914](https://github.com/guzzle/guzzle/pull/2914), [#2917](https://github.com/guzzle/guzzle/pull/2917), [#2919](https://github.com/guzzle/guzzle/pull/2919), [#2945](https://github.com/guzzle/guzzle/pull/2945)
590
591
592## 7.3.0 - 2021-03-23
593
594### Added
595
596- Support for DER and P12 certificates [#2413](https://github.com/guzzle/guzzle/pull/2413)
597- Support the cURL (http://) scheme for StreamHandler proxies [#2850](https://github.com/guzzle/guzzle/pull/2850)
598- Support for `guzzlehttp/psr7:^2.0` [#2878](https://github.com/guzzle/guzzle/pull/2878)
599
600### Fixed
601
602- Handle exceptions on invalid header consistently between PHP versions and handlers [#2872](https://github.com/guzzle/guzzle/pull/2872)
603
604
605## 7.2.0 - 2020-10-10
606
607### Added
608
609- Support for PHP 8 [#2712](https://github.com/guzzle/guzzle/pull/2712), [#2715](https://github.com/guzzle/guzzle/pull/2715), [#2789](https://github.com/guzzle/guzzle/pull/2789)
610- Support passing a body summarizer to the http errors middleware [#2795](https://github.com/guzzle/guzzle/pull/2795)
611
612### Fixed
613
614- Handle exceptions during response creation [#2591](https://github.com/guzzle/guzzle/pull/2591)
615- Fix CURLOPT_ENCODING not to be overwritten [#2595](https://github.com/guzzle/guzzle/pull/2595)
616- Make sure the Request always has a body object [#2804](https://github.com/guzzle/guzzle/pull/2804)
617
618### Changed
619
620- The `TooManyRedirectsException` has a response [#2660](https://github.com/guzzle/guzzle/pull/2660)
621- Avoid "functions" from dependencies [#2712](https://github.com/guzzle/guzzle/pull/2712)
622
623### Deprecated
624
625- Using environment variable GUZZLE_CURL_SELECT_TIMEOUT [#2786](https://github.com/guzzle/guzzle/pull/2786)
626
627
628## 7.1.1 - 2020-09-30
629
630### Fixed
631
632- Incorrect EOF detection for response body streams on Windows.
633
634### Changed
635
636- We dont connect curl `sink` on HEAD requests.
637- Removed some PHP 5 workarounds
638
639
640## 7.1.0 - 2020-09-22
641
642### Added
643
644- `GuzzleHttp\MessageFormatterInterface`
645
646### Fixed
647
648- Fixed issue that caused cookies with no value not to be stored.
649- On redirects, we allow all safe methods like GET, HEAD and OPTIONS.
650- Fixed logging on empty responses.
651- Make sure MessageFormatter::format returns string
652
653### Deprecated
654
655- All functions in `GuzzleHttp` has been deprecated. Use static methods on `Utils` instead.
656- `ClientInterface::getConfig()`
657- `Client::getConfig()`
658- `Client::__call()`
659- `Utils::defaultCaBundle()`
660- `CurlFactory::LOW_CURL_VERSION_NUMBER`
661
662
663## 7.0.1 - 2020-06-27
664
665* Fix multiply defined functions fatal error [#2699](https://github.com/guzzle/guzzle/pull/2699)
666
667
668## 7.0.0 - 2020-06-27
669
670No changes since 7.0.0-rc1.
671
672
673## 7.0.0-rc1 - 2020-06-15
674
675### Changed
676
677* Use error level for logging errors in Middleware [#2629](https://github.com/guzzle/guzzle/pull/2629)
678* Disabled IDN support by default and require ext-intl to use it [#2675](https://github.com/guzzle/guzzle/pull/2675)
679
680
681## 7.0.0-beta2 - 2020-05-25
682
683### Added
684
685* Using `Utils` class instead of functions in the `GuzzleHttp` namespace. [#2546](https://github.com/guzzle/guzzle/pull/2546)
686* `ClientInterface::MAJOR_VERSION` [#2583](https://github.com/guzzle/guzzle/pull/2583)
687
688### Changed
689
690* Avoid the `getenv` function when unsafe [#2531](https://github.com/guzzle/guzzle/pull/2531)
691* Added real client methods [#2529](https://github.com/guzzle/guzzle/pull/2529)
692* Avoid functions due to global install conflicts [#2546](https://github.com/guzzle/guzzle/pull/2546)
693* Use Symfony intl-idn polyfill [#2550](https://github.com/guzzle/guzzle/pull/2550)
694* Adding methods for HTTP verbs like `Client::get()`, `Client::head()`, `Client::patch()` etc [#2529](https://github.com/guzzle/guzzle/pull/2529)
695* `ConnectException` extends `TransferException` [#2541](https://github.com/guzzle/guzzle/pull/2541)
696* Updated the default User Agent to "GuzzleHttp/7" [#2654](https://github.com/guzzle/guzzle/pull/2654)
697
698### Fixed
699
700* Various intl icu issues [#2626](https://github.com/guzzle/guzzle/pull/2626)
701
702### Removed
703
704* Pool option `pool_size` [#2528](https://github.com/guzzle/guzzle/pull/2528)
705
706
707## 7.0.0-beta1 - 2019-12-30
708
709The diff might look very big but 95% of Guzzle users will be able to upgrade without modification.
710Please see [the upgrade document](UPGRADING.md) that describes all BC breaking changes.
711
712### Added
713
714* Implement PSR-18 and dropped PHP 5 support [#2421](https://github.com/guzzle/guzzle/pull/2421) [#2474](https://github.com/guzzle/guzzle/pull/2474)
715* PHP 7 types [#2442](https://github.com/guzzle/guzzle/pull/2442) [#2449](https://github.com/guzzle/guzzle/pull/2449) [#2466](https://github.com/guzzle/guzzle/pull/2466) [#2497](https://github.com/guzzle/guzzle/pull/2497) [#2499](https://github.com/guzzle/guzzle/pull/2499)
716* IDN support for redirects [2424](https://github.com/guzzle/guzzle/pull/2424)
717
718### Changed
719
720* Dont allow passing null as third argument to `BadResponseException::__construct()` [#2427](https://github.com/guzzle/guzzle/pull/2427)
721* Use SAPI constant instead of method call [#2450](https://github.com/guzzle/guzzle/pull/2450)
722* Use native function invocation [#2444](https://github.com/guzzle/guzzle/pull/2444)
723* Better defaults for PHP installations with old ICU lib [2454](https://github.com/guzzle/guzzle/pull/2454)
724* Added visibility to all constants [#2462](https://github.com/guzzle/guzzle/pull/2462)
725* Dont allow passing `null` as URI to `Client::request()` and `Client::requestAsync()` [#2461](https://github.com/guzzle/guzzle/pull/2461)
726* Widen the exception argument to throwable [#2495](https://github.com/guzzle/guzzle/pull/2495)
727
728### Fixed
729
730* Logging when Promise rejected with a string [#2311](https://github.com/guzzle/guzzle/pull/2311)
731
732### Removed
733
734* Class `SeekException` [#2162](https://github.com/guzzle/guzzle/pull/2162)
735* `RequestException::getResponseBodySummary()` [#2425](https://github.com/guzzle/guzzle/pull/2425)
736* `CookieJar::getCookieValue()` [#2433](https://github.com/guzzle/guzzle/pull/2433)
737* `uri_template()` and `UriTemplate` [#2440](https://github.com/guzzle/guzzle/pull/2440)
738* Request options `save_to` and `exceptions` [#2464](https://github.com/guzzle/guzzle/pull/2464)
739
740
741## 6.5.2 - 2019-12-23
742
743* idn_to_ascii() fix for old PHP versions [#2489](https://github.com/guzzle/guzzle/pull/2489)
744
745
746## 6.5.1 - 2019-12-21
747
748* Better defaults for PHP installations with old ICU lib [#2454](https://github.com/guzzle/guzzle/pull/2454)
749* IDN support for redirects [#2424](https://github.com/guzzle/guzzle/pull/2424)
750
751
752## 6.5.0 - 2019-12-07
753
754* Improvement: Added support for reset internal queue in MockHandler. [#2143](https://github.com/guzzle/guzzle/pull/2143)
755* Improvement: Added support to pass arbitrary options to `curl_multi_init`. [#2287](https://github.com/guzzle/guzzle/pull/2287)
756* Fix: Gracefully handle passing `null` to the `header` option. [#2132](https://github.com/guzzle/guzzle/pull/2132)
757* Fix: `RetryMiddleware` did not do exponential delay between retires due unit mismatch. [#2132](https://github.com/guzzle/guzzle/pull/2132)
758* Fix: Prevent undefined offset when using array for ssl_key options. [#2348](https://github.com/guzzle/guzzle/pull/2348)
759* Deprecated `ClientInterface::VERSION`
760
761
762## 6.4.1 - 2019-10-23
763
764* No `guzzle.phar` was created in 6.4.0 due expired API token. This release will fix that
765* Added `parent::__construct()` to `FileCookieJar` and `SessionCookieJar`
766
767
768## 6.4.0 - 2019-10-23
769
770* Improvement: Improved error messages when using curl < 7.21.2 [#2108](https://github.com/guzzle/guzzle/pull/2108)
771* Fix: Test if response is readable before returning a summary in `RequestException::getResponseBodySummary()` [#2081](https://github.com/guzzle/guzzle/pull/2081)
772* Fix: Add support for GUZZLE_CURL_SELECT_TIMEOUT environment variable [#2161](https://github.com/guzzle/guzzle/pull/2161)
773* Improvement: Added `GuzzleHttp\Exception\InvalidArgumentException` [#2163](https://github.com/guzzle/guzzle/pull/2163)
774* Improvement: Added `GuzzleHttp\_current_time()` to use `hrtime()` if that function exists. [#2242](https://github.com/guzzle/guzzle/pull/2242)
775* Improvement: Added curl's `appconnect_time` in `TransferStats` [#2284](https://github.com/guzzle/guzzle/pull/2284)
776* Improvement: Make GuzzleException extend Throwable wherever it's available [#2273](https://github.com/guzzle/guzzle/pull/2273)
777* Fix: Prevent concurrent writes to file when saving `CookieJar` [#2335](https://github.com/guzzle/guzzle/pull/2335)
778* Improvement: Update `MockHandler` so we can test transfer time [#2362](https://github.com/guzzle/guzzle/pull/2362)
779
780
781## 6.3.3 - 2018-04-22
782
783* Fix: Default headers when decode_content is specified
784
785
786## 6.3.2 - 2018-03-26
787
788* Fix: Release process
789
790
791## 6.3.1 - 2018-03-26
792
793* Bug fix: Parsing 0 epoch expiry times in cookies [#2014](https://github.com/guzzle/guzzle/pull/2014)
794* Improvement: Better ConnectException detection [#2012](https://github.com/guzzle/guzzle/pull/2012)
795* Bug fix: Malformed domain that contains a "/" [#1999](https://github.com/guzzle/guzzle/pull/1999)
796* Bug fix: Undefined offset when a cookie has no first key-value pair [#1998](https://github.com/guzzle/guzzle/pull/1998)
797* Improvement: Support PHPUnit 6 [#1953](https://github.com/guzzle/guzzle/pull/1953)
798* Bug fix: Support empty headers [#1915](https://github.com/guzzle/guzzle/pull/1915)
799* Bug fix: Ignore case during header modifications [#1916](https://github.com/guzzle/guzzle/pull/1916)
800
801+ Minor code cleanups, documentation fixes and clarifications.
802
803
804## 6.3.0 - 2017-06-22
805
806* Feature: force IP resolution (ipv4 or ipv6) [#1608](https://github.com/guzzle/guzzle/pull/1608), [#1659](https://github.com/guzzle/guzzle/pull/1659)
807* Improvement: Don't include summary in exception message when body is empty [#1621](https://github.com/guzzle/guzzle/pull/1621)
808* Improvement: Handle `on_headers` option in MockHandler [#1580](https://github.com/guzzle/guzzle/pull/1580)
809* Improvement: Added SUSE Linux CA path [#1609](https://github.com/guzzle/guzzle/issues/1609)
810* Improvement: Use class reference for getting the name of the class instead of using hardcoded strings [#1641](https://github.com/guzzle/guzzle/pull/1641)
811* Feature: Added `read_timeout` option [#1611](https://github.com/guzzle/guzzle/pull/1611)
812* Bug fix: PHP 7.x fixes [#1685](https://github.com/guzzle/guzzle/pull/1685), [#1686](https://github.com/guzzle/guzzle/pull/1686), [#1811](https://github.com/guzzle/guzzle/pull/1811)
813* Deprecation: BadResponseException instantiation without a response [#1642](https://github.com/guzzle/guzzle/pull/1642)
814* Feature: Added NTLM auth [#1569](https://github.com/guzzle/guzzle/pull/1569)
815* Feature: Track redirect HTTP status codes [#1711](https://github.com/guzzle/guzzle/pull/1711)
816* Improvement: Check handler type during construction [#1745](https://github.com/guzzle/guzzle/pull/1745)
817* Improvement: Always include the Content-Length if there's a body [#1721](https://github.com/guzzle/guzzle/pull/1721)
818* Feature: Added convenience method to access a cookie by name [#1318](https://github.com/guzzle/guzzle/pull/1318)
819* Bug fix: Fill `CURLOPT_CAPATH` and `CURLOPT_CAINFO` properly [#1684](https://github.com/guzzle/guzzle/pull/1684)
820* Improvement: Use `\GuzzleHttp\Promise\rejection_for` function instead of object init [#1827](https://github.com/guzzle/guzzle/pull/1827)
821
822+ Minor code cleanups, documentation fixes and clarifications.
823
824
825## 6.2.3 - 2017-02-28
826
827* Fix deprecations with guzzle/psr7 version 1.4
828
829
830## 6.2.2 - 2016-10-08
831
832* Allow to pass nullable Response to delay callable
833* Only add scheme when host is present
834* Fix drain case where content-length is the literal string zero
835* Obfuscate in-URL credentials in exceptions
836
837
838## 6.2.1 - 2016-07-18
839
840* Address HTTP_PROXY security vulnerability, CVE-2016-5385:
841 https://httpoxy.org/
842* Fixing timeout bug with StreamHandler:
843 https://github.com/guzzle/guzzle/pull/1488
844* Only read up to `Content-Length` in PHP StreamHandler to avoid timeouts when
845 a server does not honor `Connection: close`.
846* Ignore URI fragment when sending requests.
847
848
849## 6.2.0 - 2016-03-21
850
851* Feature: added `GuzzleHttp\json_encode` and `GuzzleHttp\json_decode`.
852 https://github.com/guzzle/guzzle/pull/1389
853* Bug fix: Fix sleep calculation when waiting for delayed requests.
854 https://github.com/guzzle/guzzle/pull/1324
855* Feature: More flexible history containers.
856 https://github.com/guzzle/guzzle/pull/1373
857* Bug fix: defer sink stream opening in StreamHandler.
858 https://github.com/guzzle/guzzle/pull/1377
859* Bug fix: do not attempt to escape cookie values.
860 https://github.com/guzzle/guzzle/pull/1406
861* Feature: report original content encoding and length on decoded responses.
862 https://github.com/guzzle/guzzle/pull/1409
863* Bug fix: rewind seekable request bodies before dispatching to cURL.
864 https://github.com/guzzle/guzzle/pull/1422
865* Bug fix: provide an empty string to `http_build_query` for HHVM workaround.
866 https://github.com/guzzle/guzzle/pull/1367
867
868
869## 6.1.1 - 2015-11-22
870
871* Bug fix: Proxy::wrapSync() now correctly proxies to the appropriate handler
872 https://github.com/guzzle/guzzle/commit/911bcbc8b434adce64e223a6d1d14e9a8f63e4e4
873* Feature: HandlerStack is now more generic.
874 https://github.com/guzzle/guzzle/commit/f2102941331cda544745eedd97fc8fd46e1ee33e
875* Bug fix: setting verify to false in the StreamHandler now disables peer
876 verification. https://github.com/guzzle/guzzle/issues/1256
877* Feature: Middleware now uses an exception factory, including more error
878 context. https://github.com/guzzle/guzzle/pull/1282
879* Feature: better support for disabled functions.
880 https://github.com/guzzle/guzzle/pull/1287
881* Bug fix: fixed regression where MockHandler was not using `sink`.
882 https://github.com/guzzle/guzzle/pull/1292
883
884
885## 6.1.0 - 2015-09-08
886
887* Feature: Added the `on_stats` request option to provide access to transfer
888 statistics for requests. https://github.com/guzzle/guzzle/pull/1202
889* Feature: Added the ability to persist session cookies in CookieJars.
890 https://github.com/guzzle/guzzle/pull/1195
891* Feature: Some compatibility updates for Google APP Engine
892 https://github.com/guzzle/guzzle/pull/1216
893* Feature: Added support for NO_PROXY to prevent the use of a proxy based on
894 a simple set of rules. https://github.com/guzzle/guzzle/pull/1197
895* Feature: Cookies can now contain square brackets.
896 https://github.com/guzzle/guzzle/pull/1237
897* Bug fix: Now correctly parsing `=` inside of quotes in Cookies.
898 https://github.com/guzzle/guzzle/pull/1232
899* Bug fix: Cusotm cURL options now correctly override curl options of the
900 same name. https://github.com/guzzle/guzzle/pull/1221
901* Bug fix: Content-Type header is now added when using an explicitly provided
902 multipart body. https://github.com/guzzle/guzzle/pull/1218
903* Bug fix: Now ignoring Set-Cookie headers that have no name.
904* Bug fix: Reason phrase is no longer cast to an int in some cases in the
905 cURL handler. https://github.com/guzzle/guzzle/pull/1187
906* Bug fix: Remove the Authorization header when redirecting if the Host
907 header changes. https://github.com/guzzle/guzzle/pull/1207
908* Bug fix: Cookie path matching fixes
909 https://github.com/guzzle/guzzle/issues/1129
910* Bug fix: Fixing the cURL `body_as_string` setting
911 https://github.com/guzzle/guzzle/pull/1201
912* Bug fix: quotes are no longer stripped when parsing cookies.
913 https://github.com/guzzle/guzzle/issues/1172
914* Bug fix: `form_params` and `query` now always uses the `&` separator.
915 https://github.com/guzzle/guzzle/pull/1163
916* Bug fix: Adding a Content-Length to PHP stream wrapper requests if not set.
917 https://github.com/guzzle/guzzle/pull/1189
918
919
920## 6.0.2 - 2015-07-04
921
922* Fixed a memory leak in the curl handlers in which references to callbacks
923 were not being removed by `curl_reset`.
924* Cookies are now extracted properly before redirects.
925* Cookies now allow more character ranges.
926* Decoded Content-Encoding responses are now modified to correctly reflect
927 their state if the encoding was automatically removed by a handler. This
928 means that the `Content-Encoding` header may be removed an the
929 `Content-Length` modified to reflect the message size after removing the
930 encoding.
931* Added a more explicit error message when trying to use `form_params` and
932 `multipart` in the same request.
933* Several fixes for HHVM support.
934* Functions are now conditionally required using an additional level of
935 indirection to help with global Composer installations.
936
937
938## 6.0.1 - 2015-05-27
939
940* Fixed a bug with serializing the `query` request option where the `&`
941 separator was missing.
942* Added a better error message for when `body` is provided as an array. Please
943 use `form_params` or `multipart` instead.
944* Various doc fixes.
945
946
947## 6.0.0 - 2015-05-26
948
949* See the UPGRADING.md document for more information.
950* Added `multipart` and `form_params` request options.
951* Added `synchronous` request option.
952* Added the `on_headers` request option.
953* Fixed `expect` handling.
954* No longer adding default middlewares in the client ctor. These need to be
955 present on the provided handler in order to work.
956* Requests are no longer initiated when sending async requests with the
957 CurlMultiHandler. This prevents unexpected recursion from requests completing
958 while ticking the cURL loop.
959* Removed the semantics of setting `default` to `true`. This is no longer
960 required now that the cURL loop is not ticked for async requests.
961* Added request and response logging middleware.
962* No longer allowing self signed certificates when using the StreamHandler.
963* Ensuring that `sink` is valid if saving to a file.
964* Request exceptions now include a "handler context" which provides handler
965 specific contextual information.
966* Added `GuzzleHttp\RequestOptions` to allow request options to be applied
967 using constants.
968* `$maxHandles` has been removed from CurlMultiHandler.
969* `MultipartPostBody` is now part of the `guzzlehttp/psr7` package.
970
971
972## 5.3.0 - 2015-05-19
973
974* Mock now supports `save_to`
975* Marked `AbstractRequestEvent::getTransaction()` as public.
976* Fixed a bug in which multiple headers using different casing would overwrite
977 previous headers in the associative array.
978* Added `Utils::getDefaultHandler()`
979* Marked `GuzzleHttp\Client::getDefaultUserAgent` as deprecated.
980* URL scheme is now always lowercased.
981
982
983## 6.0.0-beta.1
984
985* Requires PHP >= 5.5
986* Updated to use PSR-7
987 * Requires immutable messages, which basically means an event based system
988 owned by a request instance is no longer possible.
989 * Utilizing the [Guzzle PSR-7 package](https://github.com/guzzle/psr7).
990 * Removed the dependency on `guzzlehttp/streams`. These stream abstractions
991 are available in the `guzzlehttp/psr7` package under the `GuzzleHttp\Psr7`
992 namespace.
993* Added middleware and handler system
994 * Replaced the Guzzle event and subscriber system with a middleware system.
995 * No longer depends on RingPHP, but rather places the HTTP handlers directly
996 in Guzzle, operating on PSR-7 messages.
997 * Retry logic is now encapsulated in `GuzzleHttp\Middleware::retry`, which
998 means the `guzzlehttp/retry-subscriber` is now obsolete.
999 * Mocking responses is now handled using `GuzzleHttp\Handler\MockHandler`.
1000* Asynchronous responses
1001 * No longer supports the `future` request option to send an async request.
1002 Instead, use one of the `*Async` methods of a client (e.g., `requestAsync`,
1003 `getAsync`, etc.).
1004 * Utilizing `GuzzleHttp\Promise` instead of React's promise library to avoid
1005 recursion required by chaining and forwarding react promises. See
1006 https://github.com/guzzle/promises
1007 * Added `requestAsync` and `sendAsync` to send request asynchronously.
1008 * Added magic methods for `getAsync()`, `postAsync()`, etc. to send requests
1009 asynchronously.
1010* Request options
1011 * POST and form updates
1012 * Added the `form_fields` and `form_files` request options.
1013 * Removed the `GuzzleHttp\Post` namespace.
1014 * The `body` request option no longer accepts an array for POST requests.
1015 * The `exceptions` request option has been deprecated in favor of the
1016 `http_errors` request options.
1017 * The `save_to` request option has been deprecated in favor of `sink` request
1018 option.
1019* Clients no longer accept an array of URI template string and variables for
1020 URI variables. You will need to expand URI templates before passing them
1021 into a client constructor or request method.
1022* Client methods `get()`, `post()`, `put()`, `patch()`, `options()`, etc. are
1023 now magic methods that will send synchronous requests.
1024* Replaced `Utils.php` with plain functions in `functions.php`.
1025* Removed `GuzzleHttp\Collection`.
1026* Removed `GuzzleHttp\BatchResults`. Batched pool results are now returned as
1027 an array.
1028* Removed `GuzzleHttp\Query`. Query string handling is now handled using an
1029 associative array passed into the `query` request option. The query string
1030 is serialized using PHP's `http_build_query`. If you need more control, you
1031 can pass the query string in as a string.
1032* `GuzzleHttp\QueryParser` has been replaced with the
1033 `GuzzleHttp\Psr7\parse_query`.
1034
1035
1036## 5.2.0 - 2015-01-27
1037
1038* Added `AppliesHeadersInterface` to make applying headers to a request based
1039 on the body more generic and not specific to `PostBodyInterface`.
1040* Reduced the number of stack frames needed to send requests.
1041* Nested futures are now resolved in the client rather than the RequestFsm
1042* Finishing state transitions is now handled in the RequestFsm rather than the
1043 RingBridge.
1044* Added a guard in the Pool class to not use recursion for request retries.
1045
1046
1047## 5.1.0 - 2014-12-19
1048
1049* Pool class no longer uses recursion when a request is intercepted.
1050* The size of a Pool can now be dynamically adjusted using a callback.
1051 See https://github.com/guzzle/guzzle/pull/943.
1052* Setting a request option to `null` when creating a request with a client will
1053 ensure that the option is not set. This allows you to overwrite default
1054 request options on a per-request basis.
1055 See https://github.com/guzzle/guzzle/pull/937.
1056* Added the ability to limit which protocols are allowed for redirects by
1057 specifying a `protocols` array in the `allow_redirects` request option.
1058* Nested futures due to retries are now resolved when waiting for synchronous
1059 responses. See https://github.com/guzzle/guzzle/pull/947.
1060* `"0"` is now an allowed URI path. See
1061 https://github.com/guzzle/guzzle/pull/935.
1062* `Query` no longer typehints on the `$query` argument in the constructor,
1063 allowing for strings and arrays.
1064* Exceptions thrown in the `end` event are now correctly wrapped with Guzzle
1065 specific exceptions if necessary.
1066
1067
1068## 5.0.3 - 2014-11-03
1069
1070This change updates query strings so that they are treated as un-encoded values
1071by default where the value represents an un-encoded value to send over the
1072wire. A Query object then encodes the value before sending over the wire. This
1073means that even value query string values (e.g., ":") are url encoded. This
1074makes the Query class match PHP's http_build_query function. However, if you
1075want to send requests over the wire using valid query string characters that do
1076not need to be encoded, then you can provide a string to Url::setQuery() and
1077pass true as the second argument to specify that the query string is a raw
1078string that should not be parsed or encoded (unless a call to getQuery() is
1079subsequently made, forcing the query-string to be converted into a Query
1080object).
1081
1082
1083## 5.0.2 - 2014-10-30
1084
1085* Added a trailing `\r\n` to multipart/form-data payloads. See
1086 https://github.com/guzzle/guzzle/pull/871
1087* Added a `GuzzleHttp\Pool::send()` convenience method to match the docs.
1088* Status codes are now returned as integers. See
1089 https://github.com/guzzle/guzzle/issues/881
1090* No longer overwriting an existing `application/x-www-form-urlencoded` header
1091 when sending POST requests, allowing for customized headers. See
1092 https://github.com/guzzle/guzzle/issues/877
1093* Improved path URL serialization.
1094
1095 * No longer double percent-encoding characters in the path or query string if
1096 they are already encoded.
1097 * Now properly encoding the supplied path to a URL object, instead of only
1098 encoding ' ' and '?'.
1099 * Note: This has been changed in 5.0.3 to now encode query string values by
1100 default unless the `rawString` argument is provided when setting the query
1101 string on a URL: Now allowing many more characters to be present in the
1102 query string without being percent encoded. See
1103 https://datatracker.ietf.org/doc/html/rfc3986#appendix-A
1104
1105
1106## 5.0.1 - 2014-10-16
1107
1108Bugfix release.
1109
1110* Fixed an issue where connection errors still returned response object in
1111 error and end events event though the response is unusable. This has been
1112 corrected so that a response is not returned in the `getResponse` method of
1113 these events if the response did not complete. https://github.com/guzzle/guzzle/issues/867
1114* Fixed an issue where transfer statistics were not being populated in the
1115 RingBridge. https://github.com/guzzle/guzzle/issues/866
1116
1117
1118## 5.0.0 - 2014-10-12
1119
1120Adding support for non-blocking responses and some minor API cleanup.
1121
1122### New Features
1123
1124* Added support for non-blocking responses based on `guzzlehttp/guzzle-ring`.
1125* Added a public API for creating a default HTTP adapter.
1126* Updated the redirect plugin to be non-blocking so that redirects are sent
1127 concurrently. Other plugins like this can now be updated to be non-blocking.
1128* Added a "progress" event so that you can get upload and download progress
1129 events.
1130* Added `GuzzleHttp\Pool` which implements FutureInterface and transfers
1131 requests concurrently using a capped pool size as efficiently as possible.
1132* Added `hasListeners()` to EmitterInterface.
1133* Removed `GuzzleHttp\ClientInterface::sendAll` and marked
1134 `GuzzleHttp\Client::sendAll` as deprecated (it's still there, just not the
1135 recommended way).
1136
1137### Breaking changes
1138
1139The breaking changes in this release are relatively minor. The biggest thing to
1140look out for is that request and response objects no longer implement fluent
1141interfaces.
1142
1143* Removed the fluent interfaces (i.e., `return $this`) from requests,
1144 responses, `GuzzleHttp\Collection`, `GuzzleHttp\Url`,
1145 `GuzzleHttp\Query`, `GuzzleHttp\Post\PostBody`, and
1146 `GuzzleHttp\Cookie\SetCookie`. This blog post provides a good outline of
1147 why I did this: https://ocramius.github.io/blog/fluent-interfaces-are-evil/.
1148 This also makes the Guzzle message interfaces compatible with the current
1149 PSR-7 message proposal.
1150* Removed "functions.php", so that Guzzle is truly PSR-4 compliant. Except
1151 for the HTTP request functions from function.php, these functions are now
1152 implemented in `GuzzleHttp\Utils` using camelCase. `GuzzleHttp\json_decode`
1153 moved to `GuzzleHttp\Utils::jsonDecode`. `GuzzleHttp\get_path` moved to
1154 `GuzzleHttp\Utils::getPath`. `GuzzleHttp\set_path` moved to
1155 `GuzzleHttp\Utils::setPath`. `GuzzleHttp\batch` should now be
1156 `GuzzleHttp\Pool::batch`, which returns an `objectStorage`. Using functions.php
1157 caused problems for many users: they aren't PSR-4 compliant, require an
1158 explicit include, and needed an if-guard to ensure that the functions are not
1159 declared multiple times.
1160* Rewrote adapter layer.
1161 * Removing all classes from `GuzzleHttp\Adapter`, these are now
1162 implemented as callables that are stored in `GuzzleHttp\Ring\Client`.
1163 * Removed the concept of "parallel adapters". Sending requests serially or
1164 concurrently is now handled using a single adapter.
1165 * Moved `GuzzleHttp\Adapter\Transaction` to `GuzzleHttp\Transaction`. The
1166 Transaction object now exposes the request, response, and client as public
1167 properties. The getters and setters have been removed.
1168* Removed the "headers" event. This event was only useful for changing the
1169 body a response once the headers of the response were known. You can implement
1170 a similar behavior in a number of ways. One example might be to use a
1171 FnStream that has access to the transaction being sent. For example, when the
1172 first byte is written, you could check if the response headers match your
1173 expectations, and if so, change the actual stream body that is being
1174 written to.
1175* Removed the `asArray` parameter from
1176 `GuzzleHttp\Message\MessageInterface::getHeader`. If you want to get a header
1177 value as an array, then use the newly added `getHeaderAsArray()` method of
1178 `MessageInterface`. This change makes the Guzzle interfaces compatible with
1179 the PSR-7 interfaces.
1180* `GuzzleHttp\Message\MessageFactory` no longer allows subclasses to add
1181 custom request options using double-dispatch (this was an implementation
1182 detail). Instead, you should now provide an associative array to the
1183 constructor which is a mapping of the request option name mapping to a
1184 function that applies the option value to a request.
1185* Removed the concept of "throwImmediately" from exceptions and error events.
1186 This control mechanism was used to stop a transfer of concurrent requests
1187 from completing. This can now be handled by throwing the exception or by
1188 cancelling a pool of requests or each outstanding future request individually.
1189* Updated to "GuzzleHttp\Streams" 3.0.
1190 * `GuzzleHttp\Stream\StreamInterface::getContents()` no longer accepts a
1191 `maxLen` parameter. This update makes the Guzzle streams project
1192 compatible with the current PSR-7 proposal.
1193 * `GuzzleHttp\Stream\Stream::__construct`,
1194 `GuzzleHttp\Stream\Stream::factory`, and
1195 `GuzzleHttp\Stream\Utils::create` no longer accept a size in the second
1196 argument. They now accept an associative array of options, including the
1197 "size" key and "metadata" key which can be used to provide custom metadata.
1198
1199
1200## 4.2.2 - 2014-09-08
1201
1202* Fixed a memory leak in the CurlAdapter when reusing cURL handles.
1203* No longer using `request_fulluri` in stream adapter proxies.
1204* Relative redirects are now based on the last response, not the first response.
1205
1206## 4.2.1 - 2014-08-19
1207
1208* Ensuring that the StreamAdapter does not always add a Content-Type header
1209* Adding automated github releases with a phar and zip
1210
1211## 4.2.0 - 2014-08-17
1212
1213* Now merging in default options using a case-insensitive comparison.
1214 Closes https://github.com/guzzle/guzzle/issues/767
1215* Added the ability to automatically decode `Content-Encoding` response bodies
1216 using the `decode_content` request option. This is set to `true` by default
1217 to decode the response body if it comes over the wire with a
1218 `Content-Encoding`. Set this value to `false` to disable decoding the
1219 response content, and pass a string to provide a request `Accept-Encoding`
1220 header and turn on automatic response decoding. This feature now allows you
1221 to pass an `Accept-Encoding` header in the headers of a request but still
1222 disable automatic response decoding.
1223 Closes https://github.com/guzzle/guzzle/issues/764
1224* Added the ability to throw an exception immediately when transferring
1225 requests in parallel. Closes https://github.com/guzzle/guzzle/issues/760
1226* Updating guzzlehttp/streams dependency to ~2.1
1227* No longer utilizing the now deprecated namespaced methods from the stream
1228 package.
1229
1230## 4.1.8 - 2014-08-14
1231
1232* Fixed an issue in the CurlFactory that caused setting the `stream=false`
1233 request option to throw an exception.
1234 See: https://github.com/guzzle/guzzle/issues/769
1235* TransactionIterator now calls rewind on the inner iterator.
1236 See: https://github.com/guzzle/guzzle/pull/765
1237* You can now set the `Content-Type` header to `multipart/form-data`
1238 when creating POST requests to force multipart bodies.
1239 See https://github.com/guzzle/guzzle/issues/768
1240
1241## 4.1.7 - 2014-08-07
1242
1243* Fixed an error in the HistoryPlugin that caused the same request and response
1244 to be logged multiple times when an HTTP protocol error occurs.
1245* Ensuring that cURL does not add a default Content-Type when no Content-Type
1246 has been supplied by the user. This prevents the adapter layer from modifying
1247 the request that is sent over the wire after any listeners may have already
1248 put the request in a desired state (e.g., signed the request).
1249* Throwing an exception when you attempt to send requests that have the
1250 "stream" set to true in parallel using the MultiAdapter.
1251* Only calling curl_multi_select when there are active cURL handles. This was
1252 previously changed and caused performance problems on some systems due to PHP
1253 always selecting until the maximum select timeout.
1254* Fixed a bug where multipart/form-data POST fields were not correctly
1255 aggregated (e.g., values with "&").
1256
1257## 4.1.6 - 2014-08-03
1258
1259* Added helper methods to make it easier to represent messages as strings,
1260 including getting the start line and getting headers as a string.
1261
1262## 4.1.5 - 2014-08-02
1263
1264* Automatically retrying cURL "Connection died, retrying a fresh connect"
1265 errors when possible.
1266* cURL implementation cleanup
1267* Allowing multiple event subscriber listeners to be registered per event by
1268 passing an array of arrays of listener configuration.
1269
1270## 4.1.4 - 2014-07-22
1271
1272* Fixed a bug that caused multi-part POST requests with more than one field to
1273 serialize incorrectly.
1274* Paths can now be set to "0"
1275* `ResponseInterface::xml` now accepts a `libxml_options` option and added a
1276 missing default argument that was required when parsing XML response bodies.
1277* A `save_to` stream is now created lazily, which means that files are not
1278 created on disk unless a request succeeds.
1279
1280## 4.1.3 - 2014-07-15
1281
1282* Various fixes to multipart/form-data POST uploads
1283* Wrapping function.php in an if-statement to ensure Guzzle can be used
1284 globally and in a Composer install
1285* Fixed an issue with generating and merging in events to an event array
1286* POST headers are only applied before sending a request to allow you to change
1287 the query aggregator used before uploading
1288* Added much more robust query string parsing
1289* Fixed various parsing and normalization issues with URLs
1290* Fixing an issue where multi-valued headers were not being utilized correctly
1291 in the StreamAdapter
1292
1293## 4.1.2 - 2014-06-18
1294
1295* Added support for sending payloads with GET requests
1296
1297## 4.1.1 - 2014-06-08
1298
1299* Fixed an issue related to using custom message factory options in subclasses
1300* Fixed an issue with nested form fields in a multi-part POST
1301* Fixed an issue with using the `json` request option for POST requests
1302* Added `ToArrayInterface` to `GuzzleHttp\Cookie\CookieJar`
1303
1304## 4.1.0 - 2014-05-27
1305
1306* Added a `json` request option to easily serialize JSON payloads.
1307* Added a `GuzzleHttp\json_decode()` wrapper to safely parse JSON.
1308* Added `setPort()` and `getPort()` to `GuzzleHttp\Message\RequestInterface`.
1309* Added the ability to provide an emitter to a client in the client constructor.
1310* Added the ability to persist a cookie session using $_SESSION.
1311* Added a trait that can be used to add event listeners to an iterator.
1312* Removed request method constants from RequestInterface.
1313* Fixed warning when invalid request start-lines are received.
1314* Updated MessageFactory to work with custom request option methods.
1315* Updated cacert bundle to latest build.
1316
13174.0.2 (2014-04-16)
1318------------------
1319
1320* Proxy requests using the StreamAdapter now properly use request_fulluri (#632)
1321* Added the ability to set scalars as POST fields (#628)
1322
1323## 4.0.1 - 2014-04-04
1324
1325* The HTTP status code of a response is now set as the exception code of
1326 RequestException objects.
1327* 303 redirects will now correctly switch from POST to GET requests.
1328* The default parallel adapter of a client now correctly uses the MultiAdapter.
1329* HasDataTrait now initializes the internal data array as an empty array so
1330 that the toArray() method always returns an array.
1331
1332## 4.0.0 - 2014-03-29
1333
1334* For information on changes and upgrading, see:
1335 https://github.com/guzzle/guzzle/blob/4.x/UPGRADING.md#3x-to-40
1336* Added `GuzzleHttp\batch()` as a convenience function for sending requests in
1337 parallel without needing to write asynchronous code.
1338* Restructured how events are added to `GuzzleHttp\ClientInterface::sendAll()`.
1339 You can now pass a callable or an array of associative arrays where each
1340 associative array contains the "fn", "priority", and "once" keys.
1341
1342## 4.0.0.rc-2 - 2014-03-25
1343
1344* Removed `getConfig()` and `setConfig()` from clients to avoid confusion
1345 around whether things like base_url, message_factory, etc. should be able to
1346 be retrieved or modified.
1347* Added `getDefaultOption()` and `setDefaultOption()` to ClientInterface
1348* functions.php functions were renamed using snake_case to match PHP idioms
1349* Added support for `HTTP_PROXY`, `HTTPS_PROXY`, and
1350 `GUZZLE_CURL_SELECT_TIMEOUT` environment variables
1351* Added the ability to specify custom `sendAll()` event priorities
1352* Added the ability to specify custom stream context options to the stream
1353 adapter.
1354* Added a functions.php function for `get_path()` and `set_path()`
1355* CurlAdapter and MultiAdapter now use a callable to generate curl resources
1356* MockAdapter now properly reads a body and emits a `headers` event
1357* Updated Url class to check if a scheme and host are set before adding ":"
1358 and "//". This allows empty Url (e.g., "") to be serialized as "".
1359* Parsing invalid XML no longer emits warnings
1360* Curl classes now properly throw AdapterExceptions
1361* Various performance optimizations
1362* Streams are created with the faster `Stream\create()` function
1363* Marked deprecation_proxy() as internal
1364* Test server is now a collection of static methods on a class
1365
1366## 4.0.0-rc.1 - 2014-03-15
1367
1368* See https://github.com/guzzle/guzzle/blob/4.x/UPGRADING.md#3x-to-40
1369
1370## 3.8.1 - 2014-01-28
1371
1372* Bug: Always using GET requests when redirecting from a 303 response
1373* Bug: CURLOPT_SSL_VERIFYHOST is now correctly set to false when setting `$certificateAuthority` to false in
1374 `Guzzle\Http\ClientInterface::setSslVerification()`
1375* Bug: RedirectPlugin now uses strict RFC 3986 compliance when combining a base URL with a relative URL
1376* Bug: The body of a request can now be set to `"0"`
1377* Sending PHP stream requests no longer forces `HTTP/1.0`
1378* Adding more information to ExceptionCollection exceptions so that users have more context, including a stack trace of
1379 each sub-exception
1380* Updated the `$ref` attribute in service descriptions to merge over any existing parameters of a schema (rather than
1381 clobbering everything).
1382* Merging URLs will now use the query string object from the relative URL (thus allowing custom query aggregators)
1383* Query strings are now parsed in a way that they do no convert empty keys with no value to have a dangling `=`.
1384 For example `foo&bar=baz` is now correctly parsed and recognized as `foo&bar=baz` rather than `foo=&bar=baz`.
1385* Now properly escaping the regular expression delimiter when matching Cookie domains.
1386* Network access is now disabled when loading XML documents
1387
1388## 3.8.0 - 2013-12-05
1389
1390* Added the ability to define a POST name for a file
1391* JSON response parsing now properly walks additionalProperties
1392* cURL error code 18 is now retried automatically in the BackoffPlugin
1393* Fixed a cURL error when URLs contain fragments
1394* Fixed an issue in the BackoffPlugin retry event where it was trying to access all exceptions as if they were
1395 CurlExceptions
1396* CURLOPT_PROGRESS function fix for PHP 5.5 (69fcc1e)
1397* Added the ability for Guzzle to work with older versions of cURL that do not support `CURLOPT_TIMEOUT_MS`
1398* Fixed a bug that was encountered when parsing empty header parameters
1399* UriTemplate now has a `setRegex()` method to match the docs
1400* The `debug` request parameter now checks if it is truthy rather than if it exists
1401* Setting the `debug` request parameter to true shows verbose cURL output instead of using the LogPlugin
1402* Added the ability to combine URLs using strict RFC 3986 compliance
1403* Command objects can now return the validation errors encountered by the command
1404* Various fixes to cache revalidation (#437 and 29797e5)
1405* Various fixes to the AsyncPlugin
1406* Cleaned up build scripts
1407
1408## 3.7.4 - 2013-10-02
1409
1410* Bug fix: 0 is now an allowed value in a description parameter that has a default value (#430)
1411* Bug fix: SchemaFormatter now returns an integer when formatting to a Unix timestamp
1412 (see https://github.com/aws/aws-sdk-php/issues/147)
1413* Bug fix: Cleaned up and fixed URL dot segment removal to properly resolve internal dots
1414* Minimum PHP version is now properly specified as 5.3.3 (up from 5.3.2) (#420)
1415* Updated the bundled cacert.pem (#419)
1416* OauthPlugin now supports adding authentication to headers or query string (#425)
1417
1418## 3.7.3 - 2013-09-08
1419
1420* Added the ability to get the exception associated with a request/command when using `MultiTransferException` and
1421 `CommandTransferException`.
1422* Setting `additionalParameters` of a response to false is now honored when parsing responses with a service description
1423* Schemas are only injected into response models when explicitly configured.
1424* No longer guessing Content-Type based on the path of a request. Content-Type is now only guessed based on the path of
1425 an EntityBody.
1426* Bug fix: ChunkedIterator can now properly chunk a \Traversable as well as an \Iterator.
1427* Bug fix: FilterIterator now relies on `\Iterator` instead of `\Traversable`.
1428* Bug fix: Gracefully handling malformed responses in RequestMediator::writeResponseBody()
1429* Bug fix: Replaced call to canCache with canCacheRequest in the CallbackCanCacheStrategy of the CachePlugin
1430* Bug fix: Visiting XML attributes first before visiting XML children when serializing requests
1431* Bug fix: Properly parsing headers that contain commas contained in quotes
1432* Bug fix: mimetype guessing based on a filename is now case-insensitive
1433
1434## 3.7.2 - 2013-08-02
1435
1436* Bug fix: Properly URL encoding paths when using the PHP-only version of the UriTemplate expander
1437 See https://github.com/guzzle/guzzle/issues/371
1438* Bug fix: Cookie domains are now matched correctly according to RFC 6265
1439 See https://github.com/guzzle/guzzle/issues/377
1440* Bug fix: GET parameters are now used when calculating an OAuth signature
1441* Bug fix: Fixed an issue with cache revalidation where the If-None-Match header was being double quoted
1442* `Guzzle\Common\AbstractHasDispatcher::dispatch()` now returns the event that was dispatched
1443* `Guzzle\Http\QueryString::factory()` now guesses the most appropriate query aggregator to used based on the input.
1444 See https://github.com/guzzle/guzzle/issues/379
1445* Added a way to add custom domain objects to service description parsing using the `operation.parse_class` event. See
1446 https://github.com/guzzle/guzzle/pull/380
1447* cURL multi cleanup and optimizations
1448
1449## 3.7.1 - 2013-07-05
1450
1451* Bug fix: Setting default options on a client now works
1452* Bug fix: Setting options on HEAD requests now works. See #352
1453* Bug fix: Moving stream factory before send event to before building the stream. See #353
1454* Bug fix: Cookies no longer match on IP addresses per RFC 6265
1455* Bug fix: Correctly parsing header parameters that are in `<>` and quotes
1456* Added `cert` and `ssl_key` as request options
1457* `Host` header can now diverge from the host part of a URL if the header is set manually
1458* `Guzzle\Service\Command\LocationVisitor\Request\XmlVisitor` was rewritten to change from using SimpleXML to XMLWriter
1459* OAuth parameters are only added via the plugin if they aren't already set
1460* Exceptions are now thrown when a URL cannot be parsed
1461* Returning `false` if `Guzzle\Http\EntityBody::getContentMd5()` fails
1462* Not setting a `Content-MD5` on a command if calculating the Content-MD5 fails via the CommandContentMd5Plugin
1463
1464## 3.7.0 - 2013-06-10
1465
1466* See UPGRADING.md for more information on how to upgrade.
1467* Requests now support the ability to specify an array of $options when creating a request to more easily modify a
1468 request. You can pass a 'request.options' configuration setting to a client to apply default request options to
1469 every request created by a client (e.g. default query string variables, headers, curl options, etc.).
1470* Added a static facade class that allows you to use Guzzle with static methods and mount the class to `\Guzzle`.
1471 See `Guzzle\Http\StaticClient::mount`.
1472* Added `command.request_options` to `Guzzle\Service\Command\AbstractCommand` to pass request options to requests
1473 created by a command (e.g. custom headers, query string variables, timeout settings, etc.).
1474* Stream size in `Guzzle\Stream\PhpStreamRequestFactory` will now be set if Content-Length is returned in the
1475 headers of a response
1476* Added `Guzzle\Common\Collection::setPath($path, $value)` to set a value into an array using a nested key
1477 (e.g. `$collection->setPath('foo/baz/bar', 'test'); echo $collection['foo']['bar']['bar'];`)
1478* ServiceBuilders now support storing and retrieving arbitrary data
1479* CachePlugin can now purge all resources for a given URI
1480* CachePlugin can automatically purge matching cached items when a non-idempotent request is sent to a resource
1481* CachePlugin now uses the Vary header to determine if a resource is a cache hit
1482* `Guzzle\Http\Message\Response` now implements `\Serializable`
1483* Added `Guzzle\Cache\CacheAdapterFactory::fromCache()` to more easily create cache adapters
1484* `Guzzle\Service\ClientInterface::execute()` now accepts an array, single command, or Traversable
1485* Fixed a bug in `Guzzle\Http\Message\Header\Link::addLink()`
1486* Better handling of calculating the size of a stream in `Guzzle\Stream\Stream` using fstat() and caching the size
1487* `Guzzle\Common\Exception\ExceptionCollection` now creates a more readable exception message
1488* Fixing BC break: Added back the MonologLogAdapter implementation rather than extending from PsrLog so that older
1489 Symfony users can still use the old version of Monolog.
1490* Fixing BC break: Added the implementation back in for `Guzzle\Http\Message\AbstractMessage::getTokenizedHeader()`.
1491 Now triggering an E_USER_DEPRECATED warning when used. Use `$message->getHeader()->parseParams()`.
1492* Several performance improvements to `Guzzle\Common\Collection`
1493* Added an `$options` argument to the end of the following methods of `Guzzle\Http\ClientInterface`:
1494 createRequest, head, delete, put, patch, post, options, prepareRequest
1495* Added an `$options` argument to the end of `Guzzle\Http\Message\Request\RequestFactoryInterface::createRequest()`
1496* Added an `applyOptions()` method to `Guzzle\Http\Message\Request\RequestFactoryInterface`
1497* Changed `Guzzle\Http\ClientInterface::get($uri = null, $headers = null, $body = null)` to
1498 `Guzzle\Http\ClientInterface::get($uri = null, $headers = null, $options = array())`. You can still pass in a
1499 resource, string, or EntityBody into the $options parameter to specify the download location of the response.
1500* Changed `Guzzle\Common\Collection::__construct($data)` to no longer accepts a null value for `$data` but a
1501 default `array()`
1502* Added `Guzzle\Stream\StreamInterface::isRepeatable`
1503* Removed `Guzzle\Http\ClientInterface::setDefaultHeaders(). Use
1504 $client->getConfig()->setPath('request.options/headers/{header_name}', 'value')`. or
1505 $client->getConfig()->setPath('request.options/headers', array('header_name' => 'value'))`.
1506* Removed `Guzzle\Http\ClientInterface::getDefaultHeaders(). Use $client->getConfig()->getPath('request.options/headers')`.
1507* Removed `Guzzle\Http\ClientInterface::expandTemplate()`
1508* Removed `Guzzle\Http\ClientInterface::setRequestFactory()`
1509* Removed `Guzzle\Http\ClientInterface::getCurlMulti()`
1510* Removed `Guzzle\Http\Message\RequestInterface::canCache`
1511* Removed `Guzzle\Http\Message\RequestInterface::setIsRedirect`
1512* Removed `Guzzle\Http\Message\RequestInterface::isRedirect`
1513* Made `Guzzle\Http\Client::expandTemplate` and `getUriTemplate` protected methods.
1514* You can now enable E_USER_DEPRECATED warnings to see if you are using a deprecated method by setting
1515 `Guzzle\Common\Version::$emitWarnings` to true.
1516* Marked `Guzzle\Http\Message\Request::isResponseBodyRepeatable()` as deprecated. Use
1517 `$request->getResponseBody()->isRepeatable()` instead.
1518* Marked `Guzzle\Http\Message\Request::canCache()` as deprecated. Use
1519 `Guzzle\Plugin\Cache\DefaultCanCacheStrategy->canCacheRequest()` instead.
1520* Marked `Guzzle\Http\Message\Request::canCache()` as deprecated. Use
1521 `Guzzle\Plugin\Cache\DefaultCanCacheStrategy->canCacheRequest()` instead.
1522* Marked `Guzzle\Http\Message\Request::setIsRedirect()` as deprecated. Use the HistoryPlugin instead.
1523* Marked `Guzzle\Http\Message\Request::isRedirect()` as deprecated. Use the HistoryPlugin instead.
1524* Marked `Guzzle\Cache\CacheAdapterFactory::factory()` as deprecated
1525* Marked 'command.headers', 'command.response_body' and 'command.on_complete' as deprecated for AbstractCommand.
1526 These will work through Guzzle 4.0
1527* Marked 'request.params' for `Guzzle\Http\Client` as deprecated. Use [request.options][params].
1528* Marked `Guzzle\Service\Client::enableMagicMethods()` as deprecated. Magic methods can no longer be disabled on a Guzzle\Service\Client.
1529* Marked `Guzzle\Service\Client::getDefaultHeaders()` as deprecated. Use $client->getConfig()->getPath('request.options/headers')`.
1530* Marked `Guzzle\Service\Client::setDefaultHeaders()` as deprecated. Use $client->getConfig()->setPath('request.options/headers/{header_name}', 'value')`.
1531* Marked `Guzzle\Parser\Url\UrlParser` as deprecated. Just use PHP's `parse_url()` and percent encode your UTF-8.
1532* Marked `Guzzle\Common\Collection::inject()` as deprecated.
1533* Marked `Guzzle\Plugin\CurlAuth\CurlAuthPlugin` as deprecated. Use `$client->getConfig()->setPath('request.options/auth', array('user', 'pass', 'Basic|Digest');`
1534* CacheKeyProviderInterface and DefaultCacheKeyProvider are no longer used. All of this logic is handled in a
1535 CacheStorageInterface. These two objects and interface will be removed in a future version.
1536* Always setting X-cache headers on cached responses
1537* Default cache TTLs are now handled by the CacheStorageInterface of a CachePlugin
1538* `CacheStorageInterface::cache($key, Response $response, $ttl = null)` has changed to `cache(RequestInterface
1539 $request, Response $response);`
1540* `CacheStorageInterface::fetch($key)` has changed to `fetch(RequestInterface $request);`
1541* `CacheStorageInterface::delete($key)` has changed to `delete(RequestInterface $request);`
1542* Added `CacheStorageInterface::purge($url)`
1543* `DefaultRevalidation::__construct(CacheKeyProviderInterface $cacheKey, CacheStorageInterface $cache, CachePlugin
1544 $plugin)` has changed to `DefaultRevalidation::__construct(CacheStorageInterface $cache,
1545 CanCacheStrategyInterface $canCache = null)`
1546* Added `RevalidationInterface::shouldRevalidate(RequestInterface $request, Response $response)`
1547
1548## 3.6.0 - 2013-05-29
1549
1550* ServiceDescription now implements ToArrayInterface
1551* Added command.hidden_params to blacklist certain headers from being treated as additionalParameters
1552* Guzzle can now correctly parse incomplete URLs
1553* Mixed casing of headers are now forced to be a single consistent casing across all values for that header.
1554* Messages internally use a HeaderCollection object to delegate handling case-insensitive header resolution
1555* Removed the whole changedHeader() function system of messages because all header changes now go through addHeader().
1556* Specific header implementations can be created for complex headers. When a message creates a header, it uses a
1557 HeaderFactory which can map specific headers to specific header classes. There is now a Link header and
1558 CacheControl header implementation.
1559* Removed from interface: Guzzle\Http\ClientInterface::setUriTemplate
1560* Removed from interface: Guzzle\Http\ClientInterface::setCurlMulti()
1561* Removed Guzzle\Http\Message\Request::receivedRequestHeader() and implemented this functionality in
1562 Guzzle\Http\Curl\RequestMediator
1563* Removed the optional $asString parameter from MessageInterface::getHeader(). Just cast the header to a string.
1564* Removed the optional $tryChunkedTransfer option from Guzzle\Http\Message\EntityEnclosingRequestInterface
1565* Removed the $asObjects argument from Guzzle\Http\Message\MessageInterface::getHeaders()
1566* Removed Guzzle\Parser\ParserRegister::get(). Use getParser()
1567* Removed Guzzle\Parser\ParserRegister::set(). Use registerParser().
1568* All response header helper functions return a string rather than mixing Header objects and strings inconsistently
1569* Removed cURL blacklist support. This is no longer necessary now that Expect, Accept, etc. are managed by Guzzle
1570 directly via interfaces
1571* Removed the injecting of a request object onto a response object. The methods to get and set a request still exist
1572 but are a no-op until removed.
1573* Most classes that used to require a `Guzzle\Service\Command\CommandInterface` typehint now request a
1574 `Guzzle\Service\Command\ArrayCommandInterface`.
1575* Added `Guzzle\Http\Message\RequestInterface::startResponse()` to the RequestInterface to handle injecting a response
1576 on a request while the request is still being transferred
1577* The ability to case-insensitively search for header values
1578* Guzzle\Http\Message\Header::hasExactHeader
1579* Guzzle\Http\Message\Header::raw. Use getAll()
1580* Deprecated cache control specific methods on Guzzle\Http\Message\AbstractMessage. Use the CacheControl header object
1581 instead.
1582* `Guzzle\Service\Command\CommandInterface` now extends from ToArrayInterface and ArrayAccess
1583* Added the ability to cast Model objects to a string to view debug information.
1584
1585## 3.5.0 - 2013-05-13
1586
1587* Bug: Fixed a regression so that request responses are parsed only once per oncomplete event rather than multiple times
1588* Bug: Better cleanup of one-time events across the board (when an event is meant to fire once, it will now remove
1589 itself from the EventDispatcher)
1590* Bug: `Guzzle\Log\MessageFormatter` now properly writes "total_time" and "connect_time" values
1591* Bug: Cloning an EntityEnclosingRequest now clones the EntityBody too
1592* Bug: Fixed an undefined index error when parsing nested JSON responses with a sentAs parameter that reference a
1593 non-existent key
1594* Bug: All __call() method arguments are now required (helps with mocking frameworks)
1595* Deprecating Response::getRequest() and now using a shallow clone of a request object to remove a circular reference
1596 to help with refcount based garbage collection of resources created by sending a request
1597* Deprecating ZF1 cache and log adapters. These will be removed in the next major version.
1598* Deprecating `Response::getPreviousResponse()` (method signature still exists, but it's deprecated). Use the
1599 HistoryPlugin for a history.
1600* Added a `responseBody` alias for the `response_body` location
1601* Refactored internals to no longer rely on Response::getRequest()
1602* HistoryPlugin can now be cast to a string
1603* HistoryPlugin now logs transactions rather than requests and responses to more accurately keep track of the requests
1604 and responses that are sent over the wire
1605* Added `getEffectiveUrl()` and `getRedirectCount()` to Response objects
1606
1607## 3.4.3 - 2013-04-30
1608
1609* Bug fix: Fixing bug introduced in 3.4.2 where redirect responses are duplicated on the final redirected response
1610* Added a check to re-extract the temp cacert bundle from the phar before sending each request
1611
1612## 3.4.2 - 2013-04-29
1613
1614* Bug fix: Stream objects now work correctly with "a" and "a+" modes
1615* Bug fix: Removing `Transfer-Encoding: chunked` header when a Content-Length is present
1616* Bug fix: AsyncPlugin no longer forces HEAD requests
1617* Bug fix: DateTime timezones are now properly handled when using the service description schema formatter
1618* Bug fix: CachePlugin now properly handles stale-if-error directives when a request to the origin server fails
1619* Setting a response on a request will write to the custom request body from the response body if one is specified
1620* LogPlugin now writes to php://output when STDERR is undefined
1621* Added the ability to set multiple POST files for the same key in a single call
1622* application/x-www-form-urlencoded POSTs now use the utf-8 charset by default
1623* Added the ability to queue CurlExceptions to the MockPlugin
1624* Cleaned up how manual responses are queued on requests (removed "queued_response" and now using request.before_send)
1625* Configuration loading now allows remote files
1626
1627## 3.4.1 - 2013-04-16
1628
1629* Large refactoring to how CurlMulti handles work. There is now a proxy that sits in front of a pool of CurlMulti
1630 handles. This greatly simplifies the implementation, fixes a couple bugs, and provides a small performance boost.
1631* Exceptions are now properly grouped when sending requests in parallel
1632* Redirects are now properly aggregated when a multi transaction fails
1633* Redirects now set the response on the original object even in the event of a failure
1634* Bug fix: Model names are now properly set even when using $refs
1635* Added support for PHP 5.5's CurlFile to prevent warnings with the deprecated @ syntax
1636* Added support for oauth_callback in OAuth signatures
1637* Added support for oauth_verifier in OAuth signatures
1638* Added support to attempt to retrieve a command first literally, then ucfirst, the with inflection
1639
1640## 3.4.0 - 2013-04-11
1641
1642* Bug fix: URLs are now resolved correctly based on https://datatracker.ietf.org/doc/html/rfc3986#section-5.2. #289
1643* Bug fix: Absolute URLs with a path in a service description will now properly override the base URL. #289
1644* Bug fix: Parsing a query string with a single PHP array value will now result in an array. #263
1645* Bug fix: Better normalization of the User-Agent header to prevent duplicate headers. #264.
1646* Bug fix: Added `number` type to service descriptions.
1647* Bug fix: empty parameters are removed from an OAuth signature
1648* Bug fix: Revalidating a cache entry prefers the Last-Modified over the Date header
1649* Bug fix: Fixed "array to string" error when validating a union of types in a service description
1650* Bug fix: Removed code that attempted to determine the size of a stream when data is written to the stream
1651* Bug fix: Not including an `oauth_token` if the value is null in the OauthPlugin.
1652* Bug fix: Now correctly aggregating successful requests and failed requests in CurlMulti when a redirect occurs.
1653* The new default CURLOPT_TIMEOUT setting has been increased to 150 seconds so that Guzzle works on poor connections.
1654* Added a feature to EntityEnclosingRequest::setBody() that will automatically set the Content-Type of the request if
1655 the Content-Type can be determined based on the entity body or the path of the request.
1656* Added the ability to overwrite configuration settings in a client when grabbing a throwaway client from a builder.
1657* Added support for a PSR-3 LogAdapter.
1658* Added a `command.after_prepare` event
1659* Added `oauth_callback` parameter to the OauthPlugin
1660* Added the ability to create a custom stream class when using a stream factory
1661* Added a CachingEntityBody decorator
1662* Added support for `additionalParameters` in service descriptions to define how custom parameters are serialized.
1663* The bundled SSL certificate is now provided in the phar file and extracted when running Guzzle from a phar.
1664* You can now send any EntityEnclosingRequest with POST fields or POST files and cURL will handle creating bodies
1665* POST requests using a custom entity body are now treated exactly like PUT requests but with a custom cURL method. This
1666 means that the redirect behavior of POST requests with custom bodies will not be the same as POST requests that use
1667 POST fields or files (the latter is only used when emulating a form POST in the browser).
1668* Lots of cleanup to CurlHandle::factory and RequestFactory::createRequest
1669
1670## 3.3.1 - 2013-03-10
1671
1672* Added the ability to create PHP streaming responses from HTTP requests
1673* Bug fix: Running any filters when parsing response headers with service descriptions
1674* Bug fix: OauthPlugin fixes to allow for multi-dimensional array signing, and sorting parameters before signing
1675* Bug fix: Removed the adding of default empty arrays and false Booleans to responses in order to be consistent across
1676 response location visitors.
1677* Bug fix: Removed the possibility of creating configuration files with circular dependencies
1678* RequestFactory::create() now uses the key of a POST file when setting the POST file name
1679* Added xmlAllowEmpty to serialize an XML body even if no XML specific parameters are set
1680
1681## 3.3.0 - 2013-03-03
1682
1683* A large number of performance optimizations have been made
1684* Bug fix: Added 'wb' as a valid write mode for streams
1685* Bug fix: `Guzzle\Http\Message\Response::json()` now allows scalar values to be returned
1686* Bug fix: Fixed bug in `Guzzle\Http\Message\Response` where wrapping quotes were stripped from `getEtag()`
1687* BC: Removed `Guzzle\Http\Utils` class
1688* BC: Setting a service description on a client will no longer modify the client's command factories.
1689* BC: Emitting IO events from a RequestMediator is now a parameter that must be set in a request's curl options using
1690 the 'emit_io' key. This was previously set under a request's parameters using 'curl.emit_io'
1691* BC: `Guzzle\Stream\Stream::getWrapper()` and `Guzzle\Stream\Stream::getSteamType()` are no longer converted to
1692 lowercase
1693* Operation parameter objects are now lazy loaded internally
1694* Added ErrorResponsePlugin that can throw errors for responses defined in service description operations' errorResponses
1695* Added support for instantiating responseType=class responseClass classes. Classes must implement
1696 `Guzzle\Service\Command\ResponseClassInterface`
1697* Added support for additionalProperties for top-level parameters in responseType=model responseClasses. These
1698 additional properties also support locations and can be used to parse JSON responses where the outermost part of the
1699 JSON is an array
1700* Added support for nested renaming of JSON models (rename sentAs to name)
1701* CachePlugin
1702 * Added support for stale-if-error so that the CachePlugin can now serve stale content from the cache on error
1703 * Debug headers can now added to cached response in the CachePlugin
1704
1705## 3.2.0 - 2013-02-14
1706
1707* CurlMulti is no longer reused globally. A new multi object is created per-client. This helps to isolate clients.
1708* URLs with no path no longer contain a "/" by default
1709* Guzzle\Http\QueryString does no longer manages the leading "?". This is now handled in Guzzle\Http\Url.
1710* BadResponseException no longer includes the full request and response message
1711* Adding setData() to Guzzle\Service\Description\ServiceDescriptionInterface
1712* Adding getResponseBody() to Guzzle\Http\Message\RequestInterface
1713* Various updates to classes to use ServiceDescriptionInterface type hints rather than ServiceDescription
1714* Header values can now be normalized into distinct values when multiple headers are combined with a comma separated list
1715* xmlEncoding can now be customized for the XML declaration of a XML service description operation
1716* Guzzle\Http\QueryString now uses Guzzle\Http\QueryAggregator\QueryAggregatorInterface objects to add custom value
1717 aggregation and no longer uses callbacks
1718* The URL encoding implementation of Guzzle\Http\QueryString can now be customized
1719* Bug fix: Filters were not always invoked for array service description parameters
1720* Bug fix: Redirects now use a target response body rather than a temporary response body
1721* Bug fix: The default exponential backoff BackoffPlugin was not giving when the request threshold was exceeded
1722* Bug fix: Guzzle now takes the first found value when grabbing Cache-Control directives
1723
1724## 3.1.2 - 2013-01-27
1725
1726* Refactored how operation responses are parsed. Visitors now include a before() method responsible for parsing the
1727 response body. For example, the XmlVisitor now parses the XML response into an array in the before() method.
1728* Fixed an issue where cURL would not automatically decompress responses when the Accept-Encoding header was sent
1729* CURLOPT_SSL_VERIFYHOST is never set to 1 because it is deprecated (see 5e0ff2ef20f839e19d1eeb298f90ba3598784444)
1730* Fixed a bug where redirect responses were not chained correctly using getPreviousResponse()
1731* Setting default headers on a client after setting the user-agent will not erase the user-agent setting
1732
1733## 3.1.1 - 2013-01-20
1734
1735* Adding wildcard support to Guzzle\Common\Collection::getPath()
1736* Adding alias support to ServiceBuilder configs
1737* Adding Guzzle\Service\Resource\CompositeResourceIteratorFactory and cleaning up factory interface
1738
1739## 3.1.0 - 2013-01-12
1740
1741* BC: CurlException now extends from RequestException rather than BadResponseException
1742* BC: Renamed Guzzle\Plugin\Cache\CanCacheStrategyInterface::canCache() to canCacheRequest() and added CanCacheResponse()
1743* Added getData to ServiceDescriptionInterface
1744* Added context array to RequestInterface::setState()
1745* Bug: Removing hard dependency on the BackoffPlugin from Guzzle\Http
1746* Bug: Adding required content-type when JSON request visitor adds JSON to a command
1747* Bug: Fixing the serialization of a service description with custom data
1748* Made it easier to deal with exceptions thrown when transferring commands or requests in parallel by providing
1749 an array of successful and failed responses
1750* Moved getPath from Guzzle\Service\Resource\Model to Guzzle\Common\Collection
1751* Added Guzzle\Http\IoEmittingEntityBody
1752* Moved command filtration from validators to location visitors
1753* Added `extends` attributes to service description parameters
1754* Added getModels to ServiceDescriptionInterface
1755
1756## 3.0.7 - 2012-12-19
1757
1758* Fixing phar detection when forcing a cacert to system if null or true
1759* Allowing filename to be passed to `Guzzle\Http\Message\Request::setResponseBody()`
1760* Cleaning up `Guzzle\Common\Collection::inject` method
1761* Adding a response_body location to service descriptions
1762
1763## 3.0.6 - 2012-12-09
1764
1765* CurlMulti performance improvements
1766* Adding setErrorResponses() to Operation
1767* composer.json tweaks
1768
1769## 3.0.5 - 2012-11-18
1770
1771* Bug: Fixing an infinite recursion bug caused from revalidating with the CachePlugin
1772* Bug: Response body can now be a string containing "0"
1773* Bug: Using Guzzle inside of a phar uses system by default but now allows for a custom cacert
1774* Bug: QueryString::fromString now properly parses query string parameters that contain equal signs
1775* Added support for XML attributes in service description responses
1776* DefaultRequestSerializer now supports array URI parameter values for URI template expansion
1777* Added better mimetype guessing to requests and post files
1778
1779## 3.0.4 - 2012-11-11
1780
1781* Bug: Fixed a bug when adding multiple cookies to a request to use the correct glue value
1782* Bug: Cookies can now be added that have a name, domain, or value set to "0"
1783* Bug: Using the system cacert bundle when using the Phar
1784* Added json and xml methods to Response to make it easier to parse JSON and XML response data into data structures
1785* Enhanced cookie jar de-duplication
1786* Added the ability to enable strict cookie jars that throw exceptions when invalid cookies are added
1787* Added setStream to StreamInterface to actually make it possible to implement custom rewind behavior for entity bodies
1788* Added the ability to create any sort of hash for a stream rather than just an MD5 hash
1789
1790## 3.0.3 - 2012-11-04
1791
1792* Implementing redirects in PHP rather than cURL
1793* Added PECL URI template extension and using as default parser if available
1794* Bug: Fixed Content-Length parsing of Response factory
1795* Adding rewind() method to entity bodies and streams. Allows for custom rewinding of non-repeatable streams.
1796* Adding ToArrayInterface throughout library
1797* Fixing OauthPlugin to create unique nonce values per request
1798
1799## 3.0.2 - 2012-10-25
1800
1801* Magic methods are enabled by default on clients
1802* Magic methods return the result of a command
1803* Service clients no longer require a base_url option in the factory
1804* Bug: Fixed an issue with URI templates where null template variables were being expanded
1805
1806## 3.0.1 - 2012-10-22
1807
1808* Models can now be used like regular collection objects by calling filter, map, etc.
1809* Models no longer require a Parameter structure or initial data in the constructor
1810* Added a custom AppendIterator to get around a PHP bug with the `\AppendIterator`
1811
1812## 3.0.0 - 2012-10-15
1813
1814* Rewrote service description format to be based on Swagger
1815 * Now based on JSON schema
1816 * Added nested input structures and nested response models
1817 * Support for JSON and XML input and output models
1818 * Renamed `commands` to `operations`
1819 * Removed dot class notation
1820 * Removed custom types
1821* Broke the project into smaller top-level namespaces to be more component friendly
1822* Removed support for XML configs and descriptions. Use arrays or JSON files.
1823* Removed the Validation component and Inspector
1824* Moved all cookie code to Guzzle\Plugin\Cookie
1825* Magic methods on a Guzzle\Service\Client now return the command un-executed.
1826* Calling getResult() or getResponse() on a command will lazily execute the command if needed.
1827* Now shipping with cURL's CA certs and using it by default
1828* Added previousResponse() method to response objects
1829* No longer sending Accept and Accept-Encoding headers on every request
1830* Only sending an Expect header by default when a payload is greater than 1MB
1831* Added/moved client options:
1832 * curl.blacklist to curl.option.blacklist
1833 * Added ssl.certificate_authority
1834* Added a Guzzle\Iterator component
1835* Moved plugins from Guzzle\Http\Plugin to Guzzle\Plugin
1836* Added a more robust backoff retry strategy (replaced the ExponentialBackoffPlugin)
1837* Added a more robust caching plugin
1838* Added setBody to response objects
1839* Updating LogPlugin to use a more flexible MessageFormatter
1840* Added a completely revamped build process
1841* Cleaning up Collection class and removing default values from the get method
1842* Fixed ZF2 cache adapters
1843
1844## 2.8.8 - 2012-10-15
1845
1846* Bug: Fixed a cookie issue that caused dot prefixed domains to not match where popular browsers did
1847
1848## 2.8.7 - 2012-09-30
1849
1850* Bug: Fixed config file aliases for JSON includes
1851* Bug: Fixed cookie bug on a request object by using CookieParser to parse cookies on requests
1852* Bug: Removing the path to a file when sending a Content-Disposition header on a POST upload
1853* Bug: Hardening request and response parsing to account for missing parts
1854* Bug: Fixed PEAR packaging
1855* Bug: Fixed Request::getInfo
1856* Bug: Fixed cases where CURLM_CALL_MULTI_PERFORM return codes were causing curl transactions to fail
1857* Adding the ability for the namespace Iterator factory to look in multiple directories
1858* Added more getters/setters/removers from service descriptions
1859* Added the ability to remove POST fields from OAuth signatures
1860* OAuth plugin now supports 2-legged OAuth
1861
1862## 2.8.6 - 2012-09-05
1863
1864* Added the ability to modify and build service descriptions
1865* Added the use of visitors to apply parameters to locations in service descriptions using the dynamic command
1866* Added a `json` parameter location
1867* Now allowing dot notation for classes in the CacheAdapterFactory
1868* Using the union of two arrays rather than an array_merge when extending service builder services and service params
1869* Ensuring that a service is a string before doing strpos() checks on it when substituting services for references
1870 in service builder config files.
1871* Services defined in two different config files that include one another will by default replace the previously
1872 defined service, but you can now create services that extend themselves and merge their settings over the previous
1873* The JsonLoader now supports aliasing filenames with different filenames. This allows you to alias something like
1874 '_default' with a default JSON configuration file.
1875
1876## 2.8.5 - 2012-08-29
1877
1878* Bug: Suppressed empty arrays from URI templates
1879* Bug: Added the missing $options argument from ServiceDescription::factory to enable caching
1880* Added support for HTTP responses that do not contain a reason phrase in the start-line
1881* AbstractCommand commands are now invokable
1882* Added a way to get the data used when signing an Oauth request before a request is sent
1883
1884## 2.8.4 - 2012-08-15
1885
1886* Bug: Custom delay time calculations are no longer ignored in the ExponentialBackoffPlugin
1887* Added the ability to transfer entity bodies as a string rather than streamed. This gets around curl error 65. Set `body_as_string` in a request's curl options to enable.
1888* Added a StreamInterface, EntityBodyInterface, and added ftell() to Guzzle\Common\Stream
1889* Added an AbstractEntityBodyDecorator and a ReadLimitEntityBody decorator to transfer only a subset of a decorated stream
1890* Stream and EntityBody objects will now return the file position to the previous position after a read required operation (e.g. getContentMd5())
1891* Added additional response status codes
1892* Removed SSL information from the default User-Agent header
1893* DELETE requests can now send an entity body
1894* Added an EventDispatcher to the ExponentialBackoffPlugin and added an ExponentialBackoffLogger to log backoff retries
1895* Added the ability of the MockPlugin to consume mocked request bodies
1896* LogPlugin now exposes request and response objects in the extras array
1897
1898## 2.8.3 - 2012-07-30
1899
1900* Bug: Fixed a case where empty POST requests were sent as GET requests
1901* Bug: Fixed a bug in ExponentialBackoffPlugin that caused fatal errors when retrying an EntityEnclosingRequest that does not have a body
1902* Bug: Setting the response body of a request to null after completing a request, not when setting the state of a request to new
1903* Added multiple inheritance to service description commands
1904* Added an ApiCommandInterface and added `getParamNames()` and `hasParam()`
1905* Removed the default 2mb size cutoff from the Md5ValidatorPlugin so that it now defaults to validating everything
1906* Changed CurlMulti::perform to pass a smaller timeout to CurlMulti::executeHandles
1907
1908## 2.8.2 - 2012-07-24
1909
1910* Bug: Query string values set to 0 are no longer dropped from the query string
1911* Bug: A Collection object is no longer created each time a call is made to `Guzzle\Service\Command\AbstractCommand::getRequestHeaders()`
1912* Bug: `+` is now treated as an encoded space when parsing query strings
1913* QueryString and Collection performance improvements
1914* Allowing dot notation for class paths in filters attribute of a service descriptions
1915
1916## 2.8.1 - 2012-07-16
1917
1918* Loosening Event Dispatcher dependency
1919* POST redirects can now be customized using CURLOPT_POSTREDIR
1920
1921## 2.8.0 - 2012-07-15
1922
1923* BC: Guzzle\Http\Query
1924 * Query strings with empty variables will always show an equal sign unless the variable is set to QueryString::BLANK (e.g. ?acl= vs ?acl)
1925 * Changed isEncodingValues() and isEncodingFields() to isUrlEncoding()
1926 * Changed setEncodeValues(bool) and setEncodeFields(bool) to useUrlEncoding(bool)
1927 * Changed the aggregation functions of QueryString to be static methods
1928 * Can now use fromString() with querystrings that have a leading ?
1929* cURL configuration values can be specified in service descriptions using `curl.` prefixed parameters
1930* Content-Length is set to 0 before emitting the request.before_send event when sending an empty request body
1931* Cookies are no longer URL decoded by default
1932* Bug: URI template variables set to null are no longer expanded
1933
1934## 2.7.2 - 2012-07-02
1935
1936* BC: Moving things to get ready for subtree splits. Moving Inflection into Common. Moving Guzzle\Http\Parser to Guzzle\Parser.
1937* BC: Removing Guzzle\Common\Batch\Batch::count() and replacing it with isEmpty()
1938* CachePlugin now allows for a custom request parameter function to check if a request can be cached
1939* Bug fix: CachePlugin now only caches GET and HEAD requests by default
1940* Bug fix: Using header glue when transferring headers over the wire
1941* Allowing deeply nested arrays for composite variables in URI templates
1942* Batch divisors can now return iterators or arrays
1943
1944## 2.7.1 - 2012-06-26
1945
1946* Minor patch to update version number in UA string
1947* Updating build process
1948
1949## 2.7.0 - 2012-06-25
1950
1951* BC: Inflection classes moved to Guzzle\Inflection. No longer static methods. Can now inject custom inflectors into classes.
1952* BC: Removed magic setX methods from commands
1953* BC: Magic methods mapped to service description commands are now inflected in the command factory rather than the client __call() method
1954* Verbose cURL options are no longer enabled by default. Set curl.debug to true on a client to enable.
1955* Bug: Now allowing colons in a response start-line (e.g. HTTP/1.1 503 Service Unavailable: Back-end server is at capacity)
1956* Guzzle\Service\Resource\ResourceIteratorApplyBatched now internally uses the Guzzle\Common\Batch namespace
1957* Added Guzzle\Service\Plugin namespace and a PluginCollectionPlugin
1958* Added the ability to set POST fields and files in a service description
1959* Guzzle\Http\EntityBody::factory() now accepts objects with a __toString() method
1960* Adding a command.before_prepare event to clients
1961* Added BatchClosureTransfer and BatchClosureDivisor
1962* BatchTransferException now includes references to the batch divisor and transfer strategies
1963* Fixed some tests so that they pass more reliably
1964* Added Guzzle\Common\Log\ArrayLogAdapter
1965
1966## 2.6.6 - 2012-06-10
1967
1968* BC: Removing Guzzle\Http\Plugin\BatchQueuePlugin
1969* BC: Removing Guzzle\Service\Command\CommandSet
1970* Adding generic batching system (replaces the batch queue plugin and command set)
1971* Updating ZF cache and log adapters and now using ZF's composer repository
1972* Bug: Setting the name of each ApiParam when creating through an ApiCommand
1973* Adding result_type, result_doc, deprecated, and doc_url to service descriptions
1974* Bug: Changed the default cookie header casing back to 'Cookie'
1975
1976## 2.6.5 - 2012-06-03
1977
1978* BC: Renaming Guzzle\Http\Message\RequestInterface::getResourceUri() to getResource()
1979* BC: Removing unused AUTH_BASIC and AUTH_DIGEST constants from
1980* BC: Guzzle\Http\Cookie is now used to manage Set-Cookie data, not Cookie data
1981* BC: Renaming methods in the CookieJarInterface
1982* Moving almost all cookie logic out of the CookiePlugin and into the Cookie or CookieJar implementations
1983* Making the default glue for HTTP headers ';' instead of ','
1984* Adding a removeValue to Guzzle\Http\Message\Header
1985* Adding getCookies() to request interface.
1986* Making it easier to add event subscribers to HasDispatcherInterface classes. Can now directly call addSubscriber()
1987
1988## 2.6.4 - 2012-05-30
1989
1990* BC: Cleaning up how POST files are stored in EntityEnclosingRequest objects. Adding PostFile class.
1991* BC: Moving ApiCommand specific functionality from the Inspector and on to the ApiCommand
1992* Bug: Fixing magic method command calls on clients
1993* Bug: Email constraint only validates strings
1994* Bug: Aggregate POST fields when POST files are present in curl handle
1995* Bug: Fixing default User-Agent header
1996* Bug: Only appending or prepending parameters in commands if they are specified
1997* Bug: Not requiring response reason phrases or status codes to match a predefined list of codes
1998* Allowing the use of dot notation for class namespaces when using instance_of constraint
1999* Added any_match validation constraint
2000* Added an AsyncPlugin
2001* Passing request object to the calculateWait method of the ExponentialBackoffPlugin
2002* Allowing the result of a command object to be changed
2003* Parsing location and type sub values when instantiating a service description rather than over and over at runtime
2004
2005## 2.6.3 - 2012-05-23
2006
2007* [BC] Guzzle\Common\FromConfigInterface no longer requires any config options.
2008* [BC] Refactoring how POST files are stored on an EntityEnclosingRequest. They are now separate from POST fields.
2009* You can now use an array of data when creating PUT request bodies in the request factory.
2010* Removing the requirement that HTTPS requests needed a Cache-Control: public directive to be cacheable.
2011* [Http] Adding support for Content-Type in multipart POST uploads per upload
2012* [Http] Added support for uploading multiple files using the same name (foo[0], foo[1])
2013* Adding more POST data operations for easier manipulation of POST data.
2014* You can now set empty POST fields.
2015* The body of a request is only shown on EntityEnclosingRequest objects that do not use POST files.
2016* Split the Guzzle\Service\Inspector::validateConfig method into two methods. One to initialize when a command is created, and one to validate.
2017* CS updates
2018
2019## 2.6.2 - 2012-05-19
2020
2021* [Http] Better handling of nested scope requests in CurlMulti. Requests are now always prepares in the send() method rather than the addRequest() method.
2022
2023## 2.6.1 - 2012-05-19
2024
2025* [BC] Removing 'path' support in service descriptions. Use 'uri'.
2026* [BC] Guzzle\Service\Inspector::parseDocBlock is now protected. Adding getApiParamsForClass() with cache.
2027* [BC] Removing Guzzle\Common\NullObject. Use https://github.com/mtdowling/NullObject if you need it.
2028* [BC] Removing Guzzle\Common\XmlElement.
2029* All commands, both dynamic and concrete, have ApiCommand objects.
2030* Adding a fix for CurlMulti so that if all of the connections encounter some sort of curl error, then the loop exits.
2031* Adding checks to EntityEnclosingRequest so that empty POST files and fields are ignored.
2032* Making the method signature of Guzzle\Service\Builder\ServiceBuilder::factory more flexible.
2033
2034## 2.6.0 - 2012-05-15
2035
2036* [BC] Moving Guzzle\Service\Builder to Guzzle\Service\Builder\ServiceBuilder
2037* [BC] Executing a Command returns the result of the command rather than the command
2038* [BC] Moving all HTTP parsing logic to Guzzle\Http\Parsers. Allows for faster C implementations if needed.
2039* [BC] Changing the Guzzle\Http\Message\Response::setProtocol() method to accept a protocol and version in separate args.
2040* [BC] Moving ResourceIterator* to Guzzle\Service\Resource
2041* [BC] Completely refactored ResourceIterators to iterate over a cloned command object
2042* [BC] Moved Guzzle\Http\UriTemplate to Guzzle\Http\Parser\UriTemplate\UriTemplate
2043* [BC] Guzzle\Guzzle is now deprecated
2044* Moving Guzzle\Common\Guzzle::inject to Guzzle\Common\Collection::inject
2045* Adding Guzzle\Version class to give version information about Guzzle
2046* Adding Guzzle\Http\Utils class to provide getDefaultUserAgent() and getHttpDate()
2047* Adding Guzzle\Curl\CurlVersion to manage caching curl_version() data
2048* ServiceDescription and ServiceBuilder are now cacheable using similar configs
2049* Changing the format of XML and JSON service builder configs. Backwards compatible.
2050* Cleaned up Cookie parsing
2051* Trimming the default Guzzle User-Agent header
2052* Adding a setOnComplete() method to Commands that is called when a command completes
2053* Keeping track of requests that were mocked in the MockPlugin
2054* Fixed a caching bug in the CacheAdapterFactory
2055* Inspector objects can be injected into a Command object
2056* Refactoring a lot of code and tests to be case insensitive when dealing with headers
2057* Adding Guzzle\Http\Message\HeaderComparison for easy comparison of HTTP headers using a DSL
2058* Adding the ability to set global option overrides to service builder configs
2059* Adding the ability to include other service builder config files from within XML and JSON files
2060* Moving the parseQuery method out of Url and on to QueryString::fromString() as a static factory method.
2061
2062## 2.5.0 - 2012-05-08
2063
2064* Major performance improvements
2065* [BC] Simplifying Guzzle\Common\Collection. Please check to see if you are using features that are now deprecated.
2066* [BC] Using a custom validation system that allows a flyweight implementation for much faster validation. No longer using Symfony2 Validation component.
2067* [BC] No longer supporting "{{ }}" for injecting into command or UriTemplates. Use "{}"
2068* Added the ability to passed parameters to all requests created by a client
2069* Added callback functionality to the ExponentialBackoffPlugin
2070* Using microtime in ExponentialBackoffPlugin to allow more granular backoff strategies.
2071* Rewinding request stream bodies when retrying requests
2072* Exception is thrown when JSON response body cannot be decoded
2073* Added configurable magic method calls to clients and commands. This is off by default.
2074* Fixed a defect that added a hash to every parsed URL part
2075* Fixed duplicate none generation for OauthPlugin.
2076* Emitting an event each time a client is generated by a ServiceBuilder
2077* Using an ApiParams object instead of a Collection for parameters of an ApiCommand
2078* cache.* request parameters should be renamed to params.cache.*
2079* Added the ability to set arbitrary curl options on requests (disable_wire, progress, etc.). See CurlHandle.
2080* Added the ability to disable type validation of service descriptions
2081* ServiceDescriptions and ServiceBuilders are now Serializable