Change Log
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog and this project adheres to Semantic Versioning.
2.13.1 - 2026-08-24
Added
- Add support for PHP 8.6
Fixed
- Prefix relative paths that begin with a colon segment with
./instead of throwing
2.13.0 - 2026-07-16
Added
- Add
Utils::asciiToLower,asciiToUpper,asciiUcFirst,caselessEquals,caselessContains
Changed
- Use locale-independent ASCII case folding everywhere case is normalized
- Trigger a runtime deprecation for previously deprecated functionality in 2.3.0
2.12.5 - 2026-07-13
Fixed
- Compare header names and hosts with locale-independent ASCII lowercasing
- Compare hosts without locale sensitivity when detecting cross-origin redirects
2.12.4 - 2026-07-08
Changed
- Pass explicit trim characters ahead of the PHP 8.6 trim default change
Fixed
- Anchor server port and response start-line patterns to the true end of input
- Treat host-less origin-form request targets starting with
//as paths inMessage::parseRequest() - Reject raw DEL bytes in bracketed IP-literal hosts instead of parsing a mutated host
- Reject invalid bytes after a bracketed IP-literal host instead of reparsing a different host
2.12.3 - 2026-06-23
Security
- Validate the URI host so
getHost()matches the URI authority (GHSA-c2w2-prh8-qm98)
2.12.2 - 2026-06-23
Fixed
- Report URI parsing, filtering, and normalization PCRE failures explicitly
- Report HTTP message parser PCRE failures explicitly
- Fail closed when PCRE validation fails for request targets and hosts
2.12.1 - 2026-06-18
Security
- Reject CR/LF in HTTP method, protocol version, and reason phrase (GHSA-vm85-hxw5-5432)
2.12.0 - 2026-06-16
Deprecated
- Deprecated non-finite float values in
Query::build()that guzzlehttp/psr7 3.0 rejects - Deprecated non-finite float multipart contents that guzzlehttp/psr7 3.0 rejects
- Deprecated non-string scalar bodies in
Utils::streamFor(); cast them to a string for 3.0 - Deprecated non-string
Uri::withQueryValues()values; cast them to a string for 3.0
2.11.1 - 2026-06-12
Fixed
- Fixed non-finite float values emitting coercion warnings on PHP 8.5
2.11.0 - 2026-06-02
Changed
- Changed
Utils::modifyRequest()to reject conflicting URI andHostheader changes in the same call - Changed
Header::parse()to split semicolon-separated parameters without repeated regular expression lookaheads - Changed
UriComparator::isCrossOrigin()so only HTTP and HTTPS missing ports receive implicit default ports
Deprecated
- Deprecated invalid PSR-7 arguments that guzzlehttp/psr7 3.0 will require native types for
- Deprecated non-string header values that guzzlehttp/psr7 3.0 will reject
- Deprecated empty header value arrays that guzzlehttp/psr7 3.0 will reject
- Deprecated URI schemes that do not match guzzlehttp/psr7 3.0 syntax requirements
- Deprecated multipart boundary and custom part header metadata that guzzlehttp/psr7 3.0 will reject
- Deprecated reliance on automatic uppercasing of request methods; guzzlehttp/psr7 3.0 preserves method casing
- Deprecated invalid
Utils::modifyRequest()change values that guzzlehttp/psr7 3.0 will reject
Fixed
- Fixed
Utils::copyToStream()to retry short destination writes instead of dropping the unwritten remainder - Fixed
Header::parse()splitting of semicolon-separated parameters with escaped quotes
2.10.4 - 2026-05-29
Fixed
- Apply
UriNormalizerpercent-encoding normalizations to URI fragments - Make
LimitStream::getSize()return0for slices past the underlying stream end - Make
AppendStream::read()return an empty string when no streams are attached - Make
CachingStream::read()throw on an incomplete cache-target write instead of silently corrupting replays - Prevent
CachingStream::seek()from looping indefinitely when the remote stream makes no progress
2.10.3 - 2026-05-27
Fixed
- Fixed URI parsing for IPv6 literals containing embedded IPv4 addresses
- Fixed malformed UTF-8 URI strings being parsed as empty URIs
2.10.2 - 2026-05-25
Security
- Reject control and whitespace characters in URI host components (GHSA-hq7v-mx3g-29hw)
- Reject malformed Host values when constructing request URIs (GHSA-34xg-wgjx-8xph)
Fixed
- Make
ServerRequest::fromGlobals()robust against unexpected HTTP header value types in$_SERVER
2.10.1 - 2026-05-20
Fixed
- Fix
Utils::modifyRequest()with numeric header names
2.10.0 - 2026-05-19
Changed
- Harden
ServerRequest::fromGlobals()against malformed$_SERVERvalues - Prevent custom stream metadata from affecting internal size handling
- Throw when
StreamWrapper::getResource()cannot create a resource - Preserve custom request implementations in
Utils::modifyRequest() - Preserve custom URI implementations in
UriResolver::resolve() - Make
Uri::__toString()side-effect-free
2.9.1 - 2026-05-19
Fixed
- Fix parsing of relative path references containing a colon in a non-initial path segment
- Fix
CachingStream::detach()returning an incomplete resource before the decorated stream has been fully read - Fix
Message::bodySummary()returningnullwhen truncating printable UTF-8 bodies inside a multibyte character
2.9.0 - 2026-03-10
Added
- Added nested array expansion support to
MultipartStream - Added
@return statictoMessageTraitmethods
Changed
- Updated MIME type mappings
2.8.1 - 2026-03-10
Fixed
- Encode
+signs inUri::withQueryValue()andUri::withQueryValues()to prevent them being interpreted as spaces
2.8.0 - 2025-08-23
Added
- Allow empty lists as header values
Changed
- PHP 8.5 support
2.7.1 - 2025-03-27
Fixed
- Fixed uppercase IPv6 addresses in URI
Changed
- Improve uploaded file error message
2.7.0 - 2024-07-18
Added
- Add
Utils::redactUserInfo()method - Add ability to encode bools as ints in
Query::build
2.6.3 - 2024-07-18
Fixed
- Make
StreamWrapper::stream_stat()returnfalseif inner stream's size isnull
Changed
- PHP 8.4 support
2.6.2 - 2023-12-03
Fixed
- Fixed another issue with the fact that PHP transforms numeric strings in array keys to ints
Changed
- Updated links in docs to their canonical versions
- Replaced
call_user_func*with native calls
2.6.1 - 2023-08-27
Fixed
- Properly handle the fact that PHP transforms numeric strings in array keys to ints
2.6.0 - 2023-08-03
Changed
- Updated the mime type map to add some new entries, fix a couple of invalid entries, and remove an invalid entry
- Fallback to
application/octet-streamif we are unable to guess the content type for a multipart file upload
2.5.1 - 2023-08-03
Fixed
- Corrected mime type for
.accfiles toaudio/aac
Changed
- PHP 8.3 support
2.5.0 - 2023-04-17
Changed
- Adjusted
psr/http-messageversion constraint to^1.1 || ^2.0
2.4.5 - 2023-04-17
Fixed
- Prevent possible warnings on unset variables in
ServerRequest::normalizeNestedFileSpec - Fixed
Message::bodySummarywhenpreg_matchfails - Fixed header validation issue
2.4.4 - 2023-03-09
Changed
- Removed the need for
AllowDynamicPropertiesinLazyOpenStream
2.4.3 - 2022-10-26
Changed
- Replaced
sha1(uniqid())bybin2hex(random_bytes(20))
2.4.2 - 2022-10-25
Fixed
- Fixed erroneous behaviour when combining host and relative path
2.4.1 - 2022-08-28
Fixed
- Rewind body before reading in
Message::bodySummary
2.4.0 - 2022-06-20
Added
- Added provisional PHP 8.2 support
- Added
UriComparator::isCrossOriginmethod
2.3.0 - 2022-06-09
Fixed
- Added
Header::splitListmethod - Added
Utils::tryGetContentsmethod - Improved
Stream::getContentsmethod - Updated mimetype mappings
2.2.2 - 2022-06-08
Fixed
- Fix
Message::parseRequestUrifor numeric headers - Re-wrap exceptions thrown in
freadinto runtime exceptions - Throw an exception when multipart options is misformatted
2.2.1 - 2022-03-20
Fixed
- Correct header value validation
2.2.0 - 2022-03-20
Added
- A more compressive list of mime types
- Add JsonSerializable to Uri
- Missing return types
Fixed
- Bug MultipartStream no
urimetadata - Bug MultipartStream with filename for
data://streams - Fixed new line handling in MultipartStream
- Reduced RAM usage when copying streams
- Updated parsing in
Header::normalize()
2.1.1 - 2022-03-20
Fixed
- Validate header values properly
2.1.0 - 2021-10-06
Changed
- Attempting to create a
Uriobject from a malformed URI will no longer throw a generic
InvalidArgumentException, but rather a MalformedUriException, which inherits from the former for backwards compatibility. Callers relying on the exception being thrown to detect invalid URIs should catch the new exception.
Fixed
- Return
nullin caching stream size if remote size isnull
2.0.0 - 2021-06-30
Identical to the RC release.
2.0.0@RC-1 - 2021-04-29
Fixed
- Handle possibly unset
urlinstream_get_meta_data
2.0.0@beta-1 - 2021-03-21
Added
- PSR-17 factories
- Made classes final
- PHP7 type hints
Changed
- When building a query string, booleans are represented as 1 and 0.
Removed
- PHP < 7.2 support
- All functions in the
GuzzleHttp\Psr7namespace
1.8.1 - 2021-03-21
Fixed
- Issue parsing IPv6 URLs
- Issue modifying ServerRequest lost all its attributes
1.8.0 - 2021-03-21
Added
- Locale independent URL parsing
- Most classes got a
@finalannotation to prepare for 2.0
Fixed
- Issue when creating stream from
php://inputand curl-ext is not installed - Broken
Utils::tryFopen()on PHP 8
1.7.0 - 2020-09-30
Added
- Replaced functions by static methods
Fixed
- Converting a non-seekable stream to a string
- Handle multiple Set-Cookie correctly
- Ignore array keys in header values when merging
- Allow multibyte characters to be parsed in
Message:bodySummary()
Changed
- Restored partial HHVM 3 support
[1.6.1] - 2019-07-02
Fixed
- Accept null and bool header values again
[1.6.0] - 2019-06-30
Added
- Allowed version
^3.0ofralouphie/getallheadersdependency (#244) - Added MIME type for WEBP image format (#246)
- Added more validation of values according to PSR-7 and RFC standards, e.g. status code range (#250, #272)
Changed
- Tests don't pass with HHVM 4.0, so HHVM support got dropped. Other libraries like composer have done the same. (#262)
- Accept port number 0 to be valid (#270)
Fixed
- Fixed subsequent reads from
php://inputin ServerRequest (#247) - Fixed readable/writable detection for certain stream modes (#248)
- Fixed encoding of special characters in the
userInfocomponent of an URI (#253)
[1.5.2] - 2018-12-04
Fixed
- Check body size when getting the message summary
[1.5.1] - 2018-12-04
Fixed
- Get the summary of a body only if it is readable
[1.5.0] - 2018-12-03
Added
- Response first-line to response string exception (fixes #145)
- A test for #129 behavior
get_message_body_summaryfunction in order to get the message summary3gpandmkvmime types
Changed
- Clarify exception message when stream is detached
Deprecated
- Deprecated parsing folded header lines as per RFC 7230
Fixed
- Fix
AppendStream::detachto not close streams InflateStreampreservesisSeekableattribute of the underlying streamServerRequest::getUriFromGlobalsto support URLs in query parameters
Several other fixes and improvements.
[1.4.2] - 2017-03-20
Fixed
- Reverted BC break to
Uri::resolveandUri::removeDotSegmentsby removing
calls to trigger_error when deprecated methods are invoked.
[1.4.1] - 2017-02-27
Added
- Rriggering of silenced deprecation warnings.
Fixed
- Reverted BC break by reintroducing behavior to automagically fix a URI with a
relative path and an authority by adding a leading slash to the path. It's only deprecated now.
[1.4.0] - 2017-02-21
Added
- Added common URI utility methods based on RFC 3986 (see documentation in the readme):
Uri::isDefaultPortUri::isAbsoluteUri::isNetworkPathReferenceUri::isAbsolutePathReferenceUri::isRelativePathReferenceUri::isSameDocumentReferenceUri::composeComponentsUriNormalizer::normalizeUriNormalizer::isEquivalentUriResolver::relativize
Changed
- Ensure
ServerRequest::getUriFromGlobalsreturns a URI in absolute form. - Allow
parse_responseto parse a response without delimiting space and reason. - Ensure each URI modification results in a valid URI according to PSR-7 discussions.
Invalid modifications will throw an exception instead of returning a wrong URI or doing some magic.
(new Uri)->withPath('foo')->withHost('example.com')will throw an exception
because the path of a URI with an authority must start with a slash "/" or be empty
(new Uri())->withScheme('http')will return'http://localhost'
Deprecated
Uri::resolvein favor ofUriResolver::resolveUri::removeDotSegmentsin favor ofUriResolver::removeDotSegments
Fixed
Stream::readwhen length parameter <= 0.copy_to_streamreads bytes in chunks instead ofmaxLeninto memory.ServerRequest::getUriFromGlobalswhenHostheader contains port.- Compatibility of URIs with
filescheme and empty host.
[1.3.1] - 2016-06-25
Fixed
Uri::__toStringfor network path references, e.g.//example.org.- Missing lowercase normalization for host.
- Handling of URI components in case they are
'0'in a lot of places,
e.g. as a user info password.
Uri::withAddedHeaderto correctly merge headers with different case.- Trimming of header values in
Uri::withAddedHeader. Header values may
be surrounded by whitespace which should be ignored according to RFC 7230 Section 3.2.4. This does not apply to header names.
Uri::withAddedHeaderwith an array of header values.Uri::resolvewhen base path has no slash and handling of fragment.- Handling of encoding in
Uri::with(out)QueryValueso one can pass the
key/value both in encoded as well as decoded form to those methods. This is consistent with withPath, withQuery etc.
ServerRequest::withoutAttributewhen attribute value is null.
[1.3.0] - 2016-04-13
Added
- Remaining interfaces needed for full PSR7 compatibility
(ServerRequestInterface, UploadedFileInterface, etc.).
- Support for stream_for from scalars.
Changed
- Can now extend Uri.
Fixed
- A bug in validating request methods by making it more permissive.
[1.2.3] - 2016-02-18
Fixed
- Support in
GuzzleHttp\Psr7\CachingStreamfor seeking forward on remote
streams, which can sometimes return fewer bytes than requested with fread.
- Handling of gzipped responses with FNAME headers.
[1.2.2] - 2016-01-22
Added
- Support for URIs without any authority.
- Support for HTTP 451 'Unavailable For Legal Reasons.'
- Support for using '0' as a filename.
- Support for including non-standard ports in Host headers.
[1.2.1] - 2015-11-02
Changes
- Now supporting negative offsets when seeking to SEEK_END.
[1.2.0] - 2015-08-15
Changed
- Body as
"0"is now properly added to a response. - Now allowing forward seeking in CachingStream.
- Now properly parsing HTTP requests that contain proxy targets in
parse_request.
- functions.php is now conditionally required.
- user-info is no longer dropped when resolving URIs.
[1.1.0] - 2015-06-24
Changed
- URIs can now be relative.
multipart/form-dataheaders are now overridden case-insensitively.- URI paths no longer encode the following characters because they are allowed
in URIs: "(", ")", "*", "!", "'"
- A port is no longer added to a URI when the scheme is missing and no port is
present.
1.0.0 - 2015-05-19
Initial release.
Currently unsupported:
Psr\Http\Message\ServerRequestInterfacePsr\Http\Message\UploadedFileInterface
[1.6.0]: https://github.com/guzzle/psr7/compare/1.5.2...1.6.0 [1.5.2]: https://github.com/guzzle/psr7/compare/1.5.1...1.5.2 [1.5.1]: https://github.com/guzzle/psr7/compare/1.5.0...1.5.1 [1.5.0]: https://github.com/guzzle/psr7/compare/1.4.2...1.5.0 [1.4.2]: https://github.com/guzzle/psr7/compare/1.4.1...1.4.2 [1.4.1]: https://github.com/guzzle/psr7/compare/1.4.0...1.4.1 [1.4.0]: https://github.com/guzzle/psr7/compare/1.3.1...1.4.0 [1.3.1]: https://github.com/guzzle/psr7/compare/1.3.0...1.3.1 [1.3.0]: https://github.com/guzzle/psr7/compare/1.2.3...1.3.0 [1.2.3]: https://github.com/guzzle/psr7/compare/1.2.2...1.2.3 [1.2.2]: https://github.com/guzzle/psr7/compare/1.2.1...1.2.2 [1.2.1]: https://github.com/guzzle/psr7/compare/1.2.0...1.2.1 [1.2.0]: https://github.com/guzzle/psr7/compare/1.1.0...1.2.0 [1.1.0]: https://github.com/guzzle/psr7/compare/1.0.0...1.1.0
Source
| 1 | # Change Log |
| 2 | |
| 3 | All notable changes to this project will be documented in this file. |
| 4 | |
| 5 | The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) |
| 6 | and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). |
| 7 | |
| 8 | ## 2.13.1 - 2026-08-24 |
| 9 | |
| 10 | ### Added |
| 11 | |
| 12 | - Add support for PHP 8.6 |
| 13 | |
| 14 | ### Fixed |
| 15 | |
| 16 | - Prefix relative paths that begin with a colon segment with `./` instead of throwing |
| 17 | |
| 18 | ## 2.13.0 - 2026-07-16 |
| 19 | |
| 20 | ### Added |
| 21 | |
| 22 | - Add `Utils::` `asciiToLower`, `asciiToUpper`, `asciiUcFirst`, `caselessEquals`, `caselessContains` |
| 23 | |
| 24 | ### Changed |
| 25 | |
| 26 | - Use locale-independent ASCII case folding everywhere case is normalized |
| 27 | - Trigger a runtime deprecation for previously deprecated functionality in 2.3.0 |
| 28 | |
| 29 | ## 2.12.5 - 2026-07-13 |
| 30 | |
| 31 | ### Fixed |
| 32 | |
| 33 | - Compare header names and hosts with locale-independent ASCII lowercasing |
| 34 | - Compare hosts without locale sensitivity when detecting cross-origin redirects |
| 35 | |
| 36 | ## 2.12.4 - 2026-07-08 |
| 37 | |
| 38 | ### Changed |
| 39 | |
| 40 | - Pass explicit trim characters ahead of the PHP 8.6 trim default change |
| 41 | |
| 42 | ### Fixed |
| 43 | |
| 44 | - Anchor server port and response start-line patterns to the true end of input |
| 45 | - Treat host-less origin-form request targets starting with `//` as paths in `Message::parseRequest()` |
| 46 | - Reject raw DEL bytes in bracketed IP-literal hosts instead of parsing a mutated host |
| 47 | - Reject invalid bytes after a bracketed IP-literal host instead of reparsing a different host |
| 48 | |
| 49 | ## 2.12.3 - 2026-06-23 |
| 50 | |
| 51 | ### Security |
| 52 | |
| 53 | - Validate the URI host so `getHost()` matches the URI authority (GHSA-c2w2-prh8-qm98) |
| 54 | |
| 55 | ## 2.12.2 - 2026-06-23 |
| 56 | |
| 57 | ### Fixed |
| 58 | |
| 59 | - Report URI parsing, filtering, and normalization PCRE failures explicitly |
| 60 | - Report HTTP message parser PCRE failures explicitly |
| 61 | - Fail closed when PCRE validation fails for request targets and hosts |
| 62 | |
| 63 | ## 2.12.1 - 2026-06-18 |
| 64 | |
| 65 | ### Security |
| 66 | |
| 67 | - Reject CR/LF in HTTP method, protocol version, and reason phrase (GHSA-vm85-hxw5-5432) |
| 68 | |
| 69 | ## 2.12.0 - 2026-06-16 |
| 70 | |
| 71 | ### Deprecated |
| 72 | |
| 73 | - Deprecated non-finite float values in `Query::build()` that guzzlehttp/psr7 3.0 rejects |
| 74 | - Deprecated non-finite float multipart contents that guzzlehttp/psr7 3.0 rejects |
| 75 | - Deprecated non-string scalar bodies in `Utils::streamFor()`; cast them to a string for 3.0 |
| 76 | - Deprecated non-string `Uri::withQueryValues()` values; cast them to a string for 3.0 |
| 77 | |
| 78 | ## 2.11.1 - 2026-06-12 |
| 79 | |
| 80 | ### Fixed |
| 81 | |
| 82 | - Fixed non-finite float values emitting coercion warnings on PHP 8.5 |
| 83 | |
| 84 | ## 2.11.0 - 2026-06-02 |
| 85 | |
| 86 | ### Changed |
| 87 | |
| 88 | - Changed `Utils::modifyRequest()` to reject conflicting URI and `Host` header changes in the same call |
| 89 | - Changed `Header::parse()` to split semicolon-separated parameters without repeated regular expression lookaheads |
| 90 | - Changed `UriComparator::isCrossOrigin()` so only HTTP and HTTPS missing ports receive implicit default ports |
| 91 | |
| 92 | ### Deprecated |
| 93 | |
| 94 | - Deprecated invalid PSR-7 arguments that guzzlehttp/psr7 3.0 will require native types for |
| 95 | - Deprecated non-string header values that guzzlehttp/psr7 3.0 will reject |
| 96 | - Deprecated empty header value arrays that guzzlehttp/psr7 3.0 will reject |
| 97 | - Deprecated URI schemes that do not match guzzlehttp/psr7 3.0 syntax requirements |
| 98 | - Deprecated multipart boundary and custom part header metadata that guzzlehttp/psr7 3.0 will reject |
| 99 | - Deprecated reliance on automatic uppercasing of request methods; guzzlehttp/psr7 3.0 preserves method casing |
| 100 | - Deprecated invalid `Utils::modifyRequest()` change values that guzzlehttp/psr7 3.0 will reject |
| 101 | |
| 102 | ### Fixed |
| 103 | |
| 104 | - Fixed `Utils::copyToStream()` to retry short destination writes instead of dropping the unwritten remainder |
| 105 | - Fixed `Header::parse()` splitting of semicolon-separated parameters with escaped quotes |
| 106 | |
| 107 | ## 2.10.4 - 2026-05-29 |
| 108 | |
| 109 | ### Fixed |
| 110 | |
| 111 | - Apply `UriNormalizer` percent-encoding normalizations to URI fragments |
| 112 | - Make `LimitStream::getSize()` return `0` for slices past the underlying stream end |
| 113 | - Make `AppendStream::read()` return an empty string when no streams are attached |
| 114 | - Make `CachingStream::read()` throw on an incomplete cache-target write instead of silently corrupting replays |
| 115 | - Prevent `CachingStream::seek()` from looping indefinitely when the remote stream makes no progress |
| 116 | |
| 117 | ## 2.10.3 - 2026-05-27 |
| 118 | |
| 119 | ### Fixed |
| 120 | |
| 121 | - Fixed URI parsing for IPv6 literals containing embedded IPv4 addresses |
| 122 | - Fixed malformed UTF-8 URI strings being parsed as empty URIs |
| 123 | |
| 124 | ## 2.10.2 - 2026-05-25 |
| 125 | |
| 126 | ### Security |
| 127 | |
| 128 | - Reject control and whitespace characters in URI host components (GHSA-hq7v-mx3g-29hw) |
| 129 | - Reject malformed Host values when constructing request URIs (GHSA-34xg-wgjx-8xph) |
| 130 | |
| 131 | ### Fixed |
| 132 | |
| 133 | - Make `ServerRequest::fromGlobals()` robust against unexpected HTTP header value types in `$_SERVER` |
| 134 | |
| 135 | ## 2.10.1 - 2026-05-20 |
| 136 | |
| 137 | ### Fixed |
| 138 | |
| 139 | - Fix `Utils::modifyRequest()` with numeric header names |
| 140 | |
| 141 | ## 2.10.0 - 2026-05-19 |
| 142 | |
| 143 | ### Changed |
| 144 | |
| 145 | - Harden `ServerRequest::fromGlobals()` against malformed `$_SERVER` values |
| 146 | - Prevent custom stream metadata from affecting internal size handling |
| 147 | - Throw when `StreamWrapper::getResource()` cannot create a resource |
| 148 | - Preserve custom request implementations in `Utils::modifyRequest()` |
| 149 | - Preserve custom URI implementations in `UriResolver::resolve()` |
| 150 | - Make `Uri::__toString()` side-effect-free |
| 151 | |
| 152 | ## 2.9.1 - 2026-05-19 |
| 153 | |
| 154 | ### Fixed |
| 155 | |
| 156 | - Fix parsing of relative path references containing a colon in a non-initial path segment |
| 157 | - Fix `CachingStream::detach()` returning an incomplete resource before the decorated stream has been fully read |
| 158 | - Fix `Message::bodySummary()` returning `null` when truncating printable UTF-8 bodies inside a multibyte character |
| 159 | |
| 160 | ## 2.9.0 - 2026-03-10 |
| 161 | |
| 162 | ### Added |
| 163 | |
| 164 | - Added nested array expansion support to `MultipartStream` |
| 165 | - Added `@return static` to `MessageTrait` methods |
| 166 | |
| 167 | ### Changed |
| 168 | |
| 169 | - Updated MIME type mappings |
| 170 | |
| 171 | ## 2.8.1 - 2026-03-10 |
| 172 | |
| 173 | ### Fixed |
| 174 | |
| 175 | - Encode `+` signs in `Uri::withQueryValue()` and `Uri::withQueryValues()` to prevent them being interpreted as spaces |
| 176 | |
| 177 | ## 2.8.0 - 2025-08-23 |
| 178 | |
| 179 | ### Added |
| 180 | |
| 181 | - Allow empty lists as header values |
| 182 | |
| 183 | ### Changed |
| 184 | |
| 185 | - PHP 8.5 support |
| 186 | |
| 187 | ## 2.7.1 - 2025-03-27 |
| 188 | |
| 189 | ### Fixed |
| 190 | |
| 191 | - Fixed uppercase IPv6 addresses in URI |
| 192 | |
| 193 | ### Changed |
| 194 | |
| 195 | - Improve uploaded file error message |
| 196 | |
| 197 | ## 2.7.0 - 2024-07-18 |
| 198 | |
| 199 | ### Added |
| 200 | |
| 201 | - Add `Utils::redactUserInfo()` method |
| 202 | - Add ability to encode bools as ints in `Query::build` |
| 203 | |
| 204 | ## 2.6.3 - 2024-07-18 |
| 205 | |
| 206 | ### Fixed |
| 207 | |
| 208 | - Make `StreamWrapper::stream_stat()` return `false` if inner stream's size is `null` |
| 209 | |
| 210 | ### Changed |
| 211 | |
| 212 | - PHP 8.4 support |
| 213 | |
| 214 | ## 2.6.2 - 2023-12-03 |
| 215 | |
| 216 | ### Fixed |
| 217 | |
| 218 | - Fixed another issue with the fact that PHP transforms numeric strings in array keys to ints |
| 219 | |
| 220 | ### Changed |
| 221 | |
| 222 | - Updated links in docs to their canonical versions |
| 223 | - Replaced `call_user_func*` with native calls |
| 224 | |
| 225 | ## 2.6.1 - 2023-08-27 |
| 226 | |
| 227 | ### Fixed |
| 228 | |
| 229 | - Properly handle the fact that PHP transforms numeric strings in array keys to ints |
| 230 | |
| 231 | ## 2.6.0 - 2023-08-03 |
| 232 | |
| 233 | ### Changed |
| 234 | |
| 235 | - Updated the mime type map to add some new entries, fix a couple of invalid entries, and remove an invalid entry |
| 236 | - Fallback to `application/octet-stream` if we are unable to guess the content type for a multipart file upload |
| 237 | |
| 238 | ## 2.5.1 - 2023-08-03 |
| 239 | |
| 240 | ### Fixed |
| 241 | |
| 242 | - Corrected mime type for `.acc` files to `audio/aac` |
| 243 | |
| 244 | ### Changed |
| 245 | |
| 246 | - PHP 8.3 support |
| 247 | |
| 248 | ## 2.5.0 - 2023-04-17 |
| 249 | |
| 250 | ### Changed |
| 251 | |
| 252 | - Adjusted `psr/http-message` version constraint to `^1.1 || ^2.0` |
| 253 | |
| 254 | ## 2.4.5 - 2023-04-17 |
| 255 | |
| 256 | ### Fixed |
| 257 | |
| 258 | - Prevent possible warnings on unset variables in `ServerRequest::normalizeNestedFileSpec` |
| 259 | - Fixed `Message::bodySummary` when `preg_match` fails |
| 260 | - Fixed header validation issue |
| 261 | |
| 262 | ## 2.4.4 - 2023-03-09 |
| 263 | |
| 264 | ### Changed |
| 265 | |
| 266 | - Removed the need for `AllowDynamicProperties` in `LazyOpenStream` |
| 267 | |
| 268 | ## 2.4.3 - 2022-10-26 |
| 269 | |
| 270 | ### Changed |
| 271 | |
| 272 | - Replaced `sha1(uniqid())` by `bin2hex(random_bytes(20))` |
| 273 | |
| 274 | ## 2.4.2 - 2022-10-25 |
| 275 | |
| 276 | ### Fixed |
| 277 | |
| 278 | - Fixed erroneous behaviour when combining host and relative path |
| 279 | |
| 280 | ## 2.4.1 - 2022-08-28 |
| 281 | |
| 282 | ### Fixed |
| 283 | |
| 284 | - Rewind body before reading in `Message::bodySummary` |
| 285 | |
| 286 | ## 2.4.0 - 2022-06-20 |
| 287 | |
| 288 | ### Added |
| 289 | |
| 290 | - Added provisional PHP 8.2 support |
| 291 | - Added `UriComparator::isCrossOrigin` method |
| 292 | |
| 293 | ## 2.3.0 - 2022-06-09 |
| 294 | |
| 295 | ### Fixed |
| 296 | |
| 297 | - Added `Header::splitList` method |
| 298 | - Added `Utils::tryGetContents` method |
| 299 | - Improved `Stream::getContents` method |
| 300 | - Updated mimetype mappings |
| 301 | |
| 302 | ## 2.2.2 - 2022-06-08 |
| 303 | |
| 304 | ### Fixed |
| 305 | |
| 306 | - Fix `Message::parseRequestUri` for numeric headers |
| 307 | - Re-wrap exceptions thrown in `fread` into runtime exceptions |
| 308 | - Throw an exception when multipart options is misformatted |
| 309 | |
| 310 | ## 2.2.1 - 2022-03-20 |
| 311 | |
| 312 | ### Fixed |
| 313 | |
| 314 | - Correct header value validation |
| 315 | |
| 316 | ## 2.2.0 - 2022-03-20 |
| 317 | |
| 318 | ### Added |
| 319 | |
| 320 | - A more compressive list of mime types |
| 321 | - Add JsonSerializable to Uri |
| 322 | - Missing return types |
| 323 | |
| 324 | ### Fixed |
| 325 | |
| 326 | - Bug MultipartStream no `uri` metadata |
| 327 | - Bug MultipartStream with filename for `data://` streams |
| 328 | - Fixed new line handling in MultipartStream |
| 329 | - Reduced RAM usage when copying streams |
| 330 | - Updated parsing in `Header::normalize()` |
| 331 | |
| 332 | ## 2.1.1 - 2022-03-20 |
| 333 | |
| 334 | ### Fixed |
| 335 | |
| 336 | - Validate header values properly |
| 337 | |
| 338 | ## 2.1.0 - 2021-10-06 |
| 339 | |
| 340 | ### Changed |
| 341 | |
| 342 | - Attempting to create a `Uri` object from a malformed URI will no longer throw a generic |
| 343 | `InvalidArgumentException`, but rather a `MalformedUriException`, which inherits from the former |
| 344 | for backwards compatibility. Callers relying on the exception being thrown to detect invalid |
| 345 | URIs should catch the new exception. |
| 346 | |
| 347 | ### Fixed |
| 348 | |
| 349 | - Return `null` in caching stream size if remote size is `null` |
| 350 | |
| 351 | ## 2.0.0 - 2021-06-30 |
| 352 | |
| 353 | Identical to the RC release. |
| 354 | |
| 355 | ## 2.0.0@RC-1 - 2021-04-29 |
| 356 | |
| 357 | ### Fixed |
| 358 | |
| 359 | - Handle possibly unset `url` in `stream_get_meta_data` |
| 360 | |
| 361 | ## 2.0.0@beta-1 - 2021-03-21 |
| 362 | |
| 363 | ### Added |
| 364 | |
| 365 | - PSR-17 factories |
| 366 | - Made classes final |
| 367 | - PHP7 type hints |
| 368 | |
| 369 | ### Changed |
| 370 | |
| 371 | - When building a query string, booleans are represented as 1 and 0. |
| 372 | |
| 373 | ### Removed |
| 374 | |
| 375 | - PHP < 7.2 support |
| 376 | - All functions in the `GuzzleHttp\Psr7` namespace |
| 377 | |
| 378 | ## 1.8.1 - 2021-03-21 |
| 379 | |
| 380 | ### Fixed |
| 381 | |
| 382 | - Issue parsing IPv6 URLs |
| 383 | - Issue modifying ServerRequest lost all its attributes |
| 384 | |
| 385 | ## 1.8.0 - 2021-03-21 |
| 386 | |
| 387 | ### Added |
| 388 | |
| 389 | - Locale independent URL parsing |
| 390 | - Most classes got a `@final` annotation to prepare for 2.0 |
| 391 | |
| 392 | ### Fixed |
| 393 | |
| 394 | - Issue when creating stream from `php://input` and curl-ext is not installed |
| 395 | - Broken `Utils::tryFopen()` on PHP 8 |
| 396 | |
| 397 | ## 1.7.0 - 2020-09-30 |
| 398 | |
| 399 | ### Added |
| 400 | |
| 401 | - Replaced functions by static methods |
| 402 | |
| 403 | ### Fixed |
| 404 | |
| 405 | - Converting a non-seekable stream to a string |
| 406 | - Handle multiple Set-Cookie correctly |
| 407 | - Ignore array keys in header values when merging |
| 408 | - Allow multibyte characters to be parsed in `Message:bodySummary()` |
| 409 | |
| 410 | ### Changed |
| 411 | |
| 412 | - Restored partial HHVM 3 support |
| 413 | |
| 414 | |
| 415 | ## [1.6.1] - 2019-07-02 |
| 416 | |
| 417 | ### Fixed |
| 418 | |
| 419 | - Accept null and bool header values again |
| 420 | |
| 421 | |
| 422 | ## [1.6.0] - 2019-06-30 |
| 423 | |
| 424 | ### Added |
| 425 | |
| 426 | - Allowed version `^3.0` of `ralouphie/getallheaders` dependency (#244) |
| 427 | - Added MIME type for WEBP image format (#246) |
| 428 | - Added more validation of values according to PSR-7 and RFC standards, e.g. status code range (#250, #272) |
| 429 | |
| 430 | ### Changed |
| 431 | |
| 432 | - Tests don't pass with HHVM 4.0, so HHVM support got dropped. Other libraries like composer have done the same. (#262) |
| 433 | - Accept port number 0 to be valid (#270) |
| 434 | |
| 435 | ### Fixed |
| 436 | |
| 437 | - Fixed subsequent reads from `php://input` in ServerRequest (#247) |
| 438 | - Fixed readable/writable detection for certain stream modes (#248) |
| 439 | - Fixed encoding of special characters in the `userInfo` component of an URI (#253) |
| 440 | |
| 441 | |
| 442 | ## [1.5.2] - 2018-12-04 |
| 443 | |
| 444 | ### Fixed |
| 445 | |
| 446 | - Check body size when getting the message summary |
| 447 | |
| 448 | |
| 449 | ## [1.5.1] - 2018-12-04 |
| 450 | |
| 451 | ### Fixed |
| 452 | |
| 453 | - Get the summary of a body only if it is readable |
| 454 | |
| 455 | |
| 456 | ## [1.5.0] - 2018-12-03 |
| 457 | |
| 458 | ### Added |
| 459 | |
| 460 | - Response first-line to response string exception (fixes #145) |
| 461 | - A test for #129 behavior |
| 462 | - `get_message_body_summary` function in order to get the message summary |
| 463 | - `3gp` and `mkv` mime types |
| 464 | |
| 465 | ### Changed |
| 466 | |
| 467 | - Clarify exception message when stream is detached |
| 468 | |
| 469 | ### Deprecated |
| 470 | |
| 471 | - Deprecated parsing folded header lines as per RFC 7230 |
| 472 | |
| 473 | ### Fixed |
| 474 | |
| 475 | - Fix `AppendStream::detach` to not close streams |
| 476 | - `InflateStream` preserves `isSeekable` attribute of the underlying stream |
| 477 | - `ServerRequest::getUriFromGlobals` to support URLs in query parameters |
| 478 | |
| 479 | |
| 480 | Several other fixes and improvements. |
| 481 | |
| 482 | |
| 483 | ## [1.4.2] - 2017-03-20 |
| 484 | |
| 485 | ### Fixed |
| 486 | |
| 487 | - Reverted BC break to `Uri::resolve` and `Uri::removeDotSegments` by removing |
| 488 | calls to `trigger_error` when deprecated methods are invoked. |
| 489 | |
| 490 | |
| 491 | ## [1.4.1] - 2017-02-27 |
| 492 | |
| 493 | ### Added |
| 494 | |
| 495 | - Rriggering of silenced deprecation warnings. |
| 496 | |
| 497 | ### Fixed |
| 498 | |
| 499 | - Reverted BC break by reintroducing behavior to automagically fix a URI with a |
| 500 | relative path and an authority by adding a leading slash to the path. It's only |
| 501 | deprecated now. |
| 502 | |
| 503 | |
| 504 | ## [1.4.0] - 2017-02-21 |
| 505 | |
| 506 | ### Added |
| 507 | |
| 508 | - Added common URI utility methods based on RFC 3986 (see documentation in the readme): |
| 509 | - `Uri::isDefaultPort` |
| 510 | - `Uri::isAbsolute` |
| 511 | - `Uri::isNetworkPathReference` |
| 512 | - `Uri::isAbsolutePathReference` |
| 513 | - `Uri::isRelativePathReference` |
| 514 | - `Uri::isSameDocumentReference` |
| 515 | - `Uri::composeComponents` |
| 516 | - `UriNormalizer::normalize` |
| 517 | - `UriNormalizer::isEquivalent` |
| 518 | - `UriResolver::relativize` |
| 519 | |
| 520 | ### Changed |
| 521 | |
| 522 | - Ensure `ServerRequest::getUriFromGlobals` returns a URI in absolute form. |
| 523 | - Allow `parse_response` to parse a response without delimiting space and reason. |
| 524 | - Ensure each URI modification results in a valid URI according to PSR-7 discussions. |
| 525 | Invalid modifications will throw an exception instead of returning a wrong URI or |
| 526 | doing some magic. |
| 527 | - `(new Uri)->withPath('foo')->withHost('example.com')` will throw an exception |
| 528 | because the path of a URI with an authority must start with a slash "/" or be empty |
| 529 | - `(new Uri())->withScheme('http')` will return `'http://localhost'` |
| 530 | |
| 531 | ### Deprecated |
| 532 | |
| 533 | - `Uri::resolve` in favor of `UriResolver::resolve` |
| 534 | - `Uri::removeDotSegments` in favor of `UriResolver::removeDotSegments` |
| 535 | |
| 536 | ### Fixed |
| 537 | |
| 538 | - `Stream::read` when length parameter <= 0. |
| 539 | - `copy_to_stream` reads bytes in chunks instead of `maxLen` into memory. |
| 540 | - `ServerRequest::getUriFromGlobals` when `Host` header contains port. |
| 541 | - Compatibility of URIs with `file` scheme and empty host. |
| 542 | |
| 543 | |
| 544 | ## [1.3.1] - 2016-06-25 |
| 545 | |
| 546 | ### Fixed |
| 547 | |
| 548 | - `Uri::__toString` for network path references, e.g. `//example.org`. |
| 549 | - Missing lowercase normalization for host. |
| 550 | - Handling of URI components in case they are `'0'` in a lot of places, |
| 551 | e.g. as a user info password. |
| 552 | - `Uri::withAddedHeader` to correctly merge headers with different case. |
| 553 | - Trimming of header values in `Uri::withAddedHeader`. Header values may |
| 554 | be surrounded by whitespace which should be ignored according to RFC 7230 |
| 555 | Section 3.2.4. This does not apply to header names. |
| 556 | - `Uri::withAddedHeader` with an array of header values. |
| 557 | - `Uri::resolve` when base path has no slash and handling of fragment. |
| 558 | - Handling of encoding in `Uri::with(out)QueryValue` so one can pass the |
| 559 | key/value both in encoded as well as decoded form to those methods. This is |
| 560 | consistent with withPath, withQuery etc. |
| 561 | - `ServerRequest::withoutAttribute` when attribute value is null. |
| 562 | |
| 563 | |
| 564 | ## [1.3.0] - 2016-04-13 |
| 565 | |
| 566 | ### Added |
| 567 | |
| 568 | - Remaining interfaces needed for full PSR7 compatibility |
| 569 | (ServerRequestInterface, UploadedFileInterface, etc.). |
| 570 | - Support for stream_for from scalars. |
| 571 | |
| 572 | ### Changed |
| 573 | |
| 574 | - Can now extend Uri. |
| 575 | |
| 576 | ### Fixed |
| 577 | - A bug in validating request methods by making it more permissive. |
| 578 | |
| 579 | |
| 580 | ## [1.2.3] - 2016-02-18 |
| 581 | |
| 582 | ### Fixed |
| 583 | |
| 584 | - Support in `GuzzleHttp\Psr7\CachingStream` for seeking forward on remote |
| 585 | streams, which can sometimes return fewer bytes than requested with `fread`. |
| 586 | - Handling of gzipped responses with FNAME headers. |
| 587 | |
| 588 | |
| 589 | ## [1.2.2] - 2016-01-22 |
| 590 | |
| 591 | ### Added |
| 592 | |
| 593 | - Support for URIs without any authority. |
| 594 | - Support for HTTP 451 'Unavailable For Legal Reasons.' |
| 595 | - Support for using '0' as a filename. |
| 596 | - Support for including non-standard ports in Host headers. |
| 597 | |
| 598 | |
| 599 | ## [1.2.1] - 2015-11-02 |
| 600 | |
| 601 | ### Changes |
| 602 | |
| 603 | - Now supporting negative offsets when seeking to SEEK_END. |
| 604 | |
| 605 | |
| 606 | ## [1.2.0] - 2015-08-15 |
| 607 | |
| 608 | ### Changed |
| 609 | |
| 610 | - Body as `"0"` is now properly added to a response. |
| 611 | - Now allowing forward seeking in CachingStream. |
| 612 | - Now properly parsing HTTP requests that contain proxy targets in |
| 613 | `parse_request`. |
| 614 | - functions.php is now conditionally required. |
| 615 | - user-info is no longer dropped when resolving URIs. |
| 616 | |
| 617 | |
| 618 | ## [1.1.0] - 2015-06-24 |
| 619 | |
| 620 | ### Changed |
| 621 | |
| 622 | - URIs can now be relative. |
| 623 | - `multipart/form-data` headers are now overridden case-insensitively. |
| 624 | - URI paths no longer encode the following characters because they are allowed |
| 625 | in URIs: "(", ")", "*", "!", "'" |
| 626 | - A port is no longer added to a URI when the scheme is missing and no port is |
| 627 | present. |
| 628 | |
| 629 | |
| 630 | ## 1.0.0 - 2015-05-19 |
| 631 | |
| 632 | Initial release. |
| 633 | |
| 634 | Currently unsupported: |
| 635 | |
| 636 | - `Psr\Http\Message\ServerRequestInterface` |
| 637 | - `Psr\Http\Message\UploadedFileInterface` |
| 638 | |
| 639 | |
| 640 | |
| 641 | [1.6.0]: https://github.com/guzzle/psr7/compare/1.5.2...1.6.0 |
| 642 | [1.5.2]: https://github.com/guzzle/psr7/compare/1.5.1...1.5.2 |
| 643 | [1.5.1]: https://github.com/guzzle/psr7/compare/1.5.0...1.5.1 |
| 644 | [1.5.0]: https://github.com/guzzle/psr7/compare/1.4.2...1.5.0 |
| 645 | [1.4.2]: https://github.com/guzzle/psr7/compare/1.4.1...1.4.2 |
| 646 | [1.4.1]: https://github.com/guzzle/psr7/compare/1.4.0...1.4.1 |
| 647 | [1.4.0]: https://github.com/guzzle/psr7/compare/1.3.1...1.4.0 |
| 648 | [1.3.1]: https://github.com/guzzle/psr7/compare/1.3.0...1.3.1 |
| 649 | [1.3.0]: https://github.com/guzzle/psr7/compare/1.2.3...1.3.0 |
| 650 | [1.2.3]: https://github.com/guzzle/psr7/compare/1.2.2...1.2.3 |
| 651 | [1.2.2]: https://github.com/guzzle/psr7/compare/1.2.1...1.2.2 |
| 652 | [1.2.1]: https://github.com/guzzle/psr7/compare/1.2.0...1.2.1 |
| 653 | [1.2.0]: https://github.com/guzzle/psr7/compare/1.1.0...1.2.0 |
| 654 | [1.1.0]: https://github.com/guzzle/psr7/compare/1.0.0...1.1.0 |