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.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() return false if inner stream’s size is null

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-stream if we are unable to guess the content type for a multipart file upload

2.5.1 - 2023-08-03

Fixed

• Corrected mime type for .acc files to audio/aac

Changed

• PHP 8.3 support

2.5.0 - 2023-04-17

Changed

• Adjusted psr/http-message version constraint to ^1.1 || ^2.0

2.4.5 - 2023-04-17

Fixed

• Prevent possible warnings on unset variables in ServerRequest::normalizeNestedFileSpec
• Fixed Message::bodySummary when preg_match fails
• Fixed header validation issue

2.4.4 - 2023-03-09

Changed

• Removed the need for AllowDynamicProperties in LazyOpenStream

2.4.3 - 2022-10-26

Changed

• Replaced sha1(uniqid()) by bin2hex(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::isCrossOrigin method

2.3.0 - 2022-06-09

Fixed

• Added Header::splitList method
• Added Utils::tryGetContents method
• Improved Stream::getContents method
• Updated mimetype mappings

2.2.2 - 2022-06-08

Fixed

• Fix Message::parseRequestUri for numeric headers
• Re-wrap exceptions thrown in fread into 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 uri metadata
• 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 Uri object 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 null in caching stream size if remote size is null

2.0.0 - 2021-06-30

Identical to the RC release.

2.0.0@RC-1 - 2021-04-29

Fixed

• Handle possibly unset url in stream_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\Psr7 namespace

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 @final annotation to prepare for 2.0

Fixed

• Issue when creating stream from php://input and 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.0 of ralouphie/getallheaders dependency (#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://input in ServerRequest (#247)
• Fixed readable/writable detection for certain stream modes (#248)
• Fixed encoding of special characters in the userInfo component 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_summary function in order to get the message summary
• 3gp and mkv mime types

Changed

• Clarify exception message when stream is detached

Deprecated

• Deprecated parsing folded header lines as per RFC 7230

Fixed

• Fix AppendStream::detach to not close streams
• InflateStream preserves isSeekable attribute of the underlying stream
• ServerRequest::getUriFromGlobals to support URLs in query parameters

Several other fixes and improvements.

1.4.2 - 2017-03-20

Fixed

• Reverted BC break to Uri::resolve and Uri::removeDotSegments by 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::isDefaultPort
  • Uri::isAbsolute
  • Uri::isNetworkPathReference
  • Uri::isAbsolutePathReference
  • Uri::isRelativePathReference
  • Uri::isSameDocumentReference
  • Uri::composeComponents
  • UriNormalizer::normalize
  • UriNormalizer::isEquivalent
  • UriResolver::relativize

Changed

• Ensure ServerRequest::getUriFromGlobals returns a URI in absolute form.
• Allow parse_response to 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::resolve in favor of UriResolver::resolve
• Uri::removeDotSegments in favor of UriResolver::removeDotSegments

Fixed

• Stream::read when length parameter <= 0.
• copy_to_stream reads bytes in chunks instead of maxLen into memory.
• ServerRequest::getUriFromGlobals when Host header contains port.
• Compatibility of URIs with file scheme and empty host.

1.3.1 - 2016-06-25

Fixed

• Uri::__toString for 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::withAddedHeader to 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::withAddedHeader with an array of header values.
• Uri::resolve when base path has no slash and handling of fragment.
• Handling of encoding in Uri::with(out)QueryValue so 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::withoutAttribute when 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\CachingStream for 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-data headers 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\ServerRequestInterface
• Psr\Http\Message\UploadedFileInterface