NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist, #357 most downloaded on Packagist
PSR HTTP Message implementations
Latest stable
3.10.0
Last release 18 days ago
04 Nov 2026
Release timing varies
gaps range from 2 weeks to 12 months
Most releases are documented
notes for 48 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
7 years old
150 releases · first in 2019
Drag across the ruler to compare, or tap a release to open it.
Total pull requests resolved: 1
Feature release (minor)
Total pull requests resolved: 5
Feature release (minor)
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Total pull requests resolved: 1
Feature release (minor)
Total pull requests resolved: 2
Feature release (minor)
Total pull requests resolved: 5
Feature release (minor)
Total pull requests resolved: 1
Total pull requests resolved: 7
Feature release (minor)
Total pull requests resolved: 1
3.3.x bugfix release (patch)
Total pull requests resolved: 2
Feature release (minor)
Total pull requests resolved: 1
Feature release (minor)
Total pull requests resolved: 3
JSON_THROW_ON_ERROR in JsonResponse thanks to @TimWollaThis version adds support for PSR-7 v2.0. While we had previously added return type hints in Diactoros, there were a few cases where PSR-7 updated the
This version adds support for PSR-7 v2.0. While we had previously added return type hints in Diactoros, there were a few cases where PSR-7 updated the interfaces to use void returns where we had not. As a result, this release represents a BC break for anybody extending our classes, as defining an extension that uses one of these methods with a mixed return type (or omitting the return type entirely) will result in a type error.
The interfaces affected were Psr\Http\Message\StreamInterface and Psr\Http\Message\UploadedFileInterface.
For consumers, this version should be entirely backwards compatible in usage. For those extending our classes, you will only run into issues when extending implementations of the above interfaces.
ServerRequestFactory::fromGlobals() checks if args are truthy rather than set thanks to @weierophinneyTotal pull requests resolved: 1
Feature release (minor)
Nothing published for this version
Total pull requests resolved: 1
2.25.x bugfix release (patch)
Total issues resolved: 0
Total pull requests resolved: 1
Total contributors: 1
138: Merge release 2.24.1 into 2.25.x thanks to @github-actions[bot]
Adds support for the PSR-7 v1.1 release.
Adds support for the PSR-7 v1.1 release.
Nothing published for this version
Total pull requests resolved: 1
2.24.x bugfix release (patch)
X-Forwarded-Host for additional port information thanks to @boesingTotal pull requests resolved: 1
Feature release (minor)
Nothing published for this version
Total pull requests resolved: 3
Feature release (minor)
Nothing published for this version
Total pull requests resolved: 1
Feature release (minor)
UriFactory::createFromSapi() thanks to @markstoryNothing published for this version
Total pull requests resolved: 1
Feature release (minor)
Nothing published for this version
Total pull requests resolved: 1
Feature release (minor)
Nothing published for this version
Total pull requests resolved: 1
Feature release (minor)
Nothing published for this version
Total pull requests resolved: 1
Feature release (minor)
Total pull requests resolved: 1
Feature release (minor)
SensitiveParameter attribute to Uri::withUserInfo() thanks to @TimWollaTotal pull requests resolved: 1
Feature release (minor)
Total pull requests resolved: 1
Feature release (minor)
Total pull requests resolved: 3
Feature release (minor)
config.allow-plugins key in composer.json thanks to @TimWollaexport-ignore attribute for /renovate.json thanks to @TimWollaTotal pull requests resolved: 4
Feature release (minor)
laminas/laminas-coding-standard:2.3.x upgrades thanks to @Ocramiuslaminas/laminas-coding-standard:2.3.x, improved types and internal API thanks to @gsteelTotal pull requests resolved: 5
Feature release (minor)
UploadedFileTest::setUp() thanks to @TimWollahost headers when constructing a ServerRequest thanks to @TimWollaTotal pull requests resolved: 1
2.11.x bugfix release (patch)
Total pull requests resolved: 1
2.11.x bugfix release (patch)
This is a SECURITY release. All users are encouraged to upgrade immediately.
This is a SECURITY release. All users are encouraged to upgrade immediately.
This release adds features to allow filtering a ServerRequest as generated by Laminas\Diactoros\ServerRequestFactory::fromGlobals() for the purposes of initialization. Examples include:
X-Forwarded-* headers to modify the URL to represent the original client request.The features are based on a new interface, Laminas\Diactorors\ServerRequestFilter\FilterServerRequestInterface, which defines a single method:
public function __invoke(
\Psr\Http\Message\ServerRequestInterface $request
): \Psr\Http\Message\ServerRequestInterface
We provide two implementations, as follows:
Laminas\Diactoros\ServerRequestFilter\DoNotFilter will return the provided request verbatim.Laminas\Diactoros\ServerRequestFilter\FilterUsingXForwardedHeaders has named constructors that allow you to define how and when X-Forwarded-* headers are used to modify the URI instance associated with the request. These methods are:
trustAny(): this method generates a filter instance that will trust all X-Forwarded-* headers from any source.trustReservedSubnets(array $trustedHeaders = ?): this method generates a filter instance that only modifies the URL if the IP address of the requesting server is from a reserved, private subnet (localhost; classes A, B, and C subnets; and IPv6 private and local-link subnets). By default, it will trust all X-Forwarded-* headers from these sources, but you may specify a list to allow via the $trustedHeaders argument.trustProxies(array $proxyCIDRList, array $trustedHeaders = ?): this method will generate a filter instance that only modifies the URL if the requesting server matches an entry in the $proxyCIDRList. These entries may be IP addresses, or any IPv4 or IPv6 CIDR subnets. By default, it will trust all X-Forwarded-* headers from these sources, but you may specify a list to allow via the $trustedHeaders argument.ServerRequestFactory::fromGlobals() now accepts a FilterServerRequestInterface instance as the optional argument $requestFilter. If none is provided, it uses one as produced by FilterUsingXForwardedHeaders::trustReservedSubnets().
Laminas\Diactoros\marshalUriFromSapi() is deprecated, and no longer used internally.Laminas\Diactoros\ServerRequestFactory::fromGlobals() no longer consumes marshalUriFromSapi(), and instead inlines an alternate implementation. The new implementation does not consider X-Forwarded-* headers by default when generating the associated URI instance. Internally, if no FilterServerRequestInterface implementation is provided, it defaults to using an instance returned by FilterUsingXForwardeHeaders::trustReservedSubnets(). If you previously relied on X-Forwarded-* headers, you MAY need to update your code to use either the FilterUsingXForwardedHeaders::trustAny() or FilterUsingXForwardedHeaders::trustProxies() methods to generate a filter to use with ServerRequestFactory::fromGlobals().
Total pull requests resolved: 2
Feature release (minor)
export-ignore attribute for .laminas-ci.json thanks to @TimWollaThis release adds minor normalization of header values with line continuations; the line continuations are now normalized to a single space. This is d
This release adds minor normalization of header values with line continuations; the line continuations are now normalized to a single space. This is done to conform to RFC 7230#3.2.4, which is an important security guideline.
use function trim; thanks to @TimWollaTotal pull requests resolved: 1
2.9.x bugfix release (patch)
Total pull requests resolved: 1
2.9.x bugfix release (patch)
Total pull requests resolved: 4
Total pull requests resolved: 3
Feature release (minor)
Total pull requests resolved: 2
Feature release (minor)
The default behavior when marshalling request headers from the $_SERVER superglobal is to map all entries starting with HTTP_ or CONTENT_ to HTTP head
$_SERVER superglobal is to map all entries starting with HTTP_ or CONTENT_ to HTTP headers. However, this behavior is a bit aggressive with regards to the CONTENT_ keys; PHP only maps CONTENT_LENGTH, CONTENT_MD5, and CONTENT_LENGTH in this way. To remain backwards compatible, we are not changing that behavior. However, users who are experiencing conflicts with env variables they have declared (as an example, CONTENT_API_KEY) can define the env variable LAMINAS_DIACTOROS_STRICT_CONTENT_HEADER_LOOKUP. When present, the logic for marshalling headers will only consider exact matches on those three CONTENT_ keys, and ignore any others it identifies. (Behavior for HTTP_ prefixed headers remains the same.)Total pull requests resolved: 1
2.5.x bugfix release (patch)
Total pull requests resolved: 2
Laminas\Diactoros\Stream::setStream() when an error occurs opening a stream resource. Previously, it would throw a Laminas\Diactoros\Exception\InvalidArgumentException; it now throws Laminas\Diactoros\Exception\RuntimeException. This was done to comply with PSR-7 integration test suites, which test behavior of PSR-7 implementations against the specification.Feature release (minor)
Total pull requests resolved: 1
2.4.x bugfix release (patch)
Total pull requests resolved: 2
Feature release (minor)
Total issues resolved: 0
Total pull requests resolved: 2
Total contributors: 2
49: Merge release 2.3.2 into 2.4.x thanks to @github-actions[bot]
Total pull requests resolved: 1
Laminas\Diactoros\Response\ArraySerializer::fromArray() to indicate Laminas\Diactoros\Exception\DeserializationException is thrown by the method.Added ----- - Nothing. Changed ------- - Nothing. Deprecated ---------- - Nothing. Removed ------- - Nothing. Fixed ----- - #44 fixes an issue whereby
UploadedFile instance.Added ----- - #37 adds a ConfigProvider and Module, allowing the package to be autoregistered within Mezzio and MVC applications. Each provides config
Fixed replace version constraint in composer.json so repository can be used as replacement of zendframework/zend-diactoros:^2.2.1.
replace version constraint in composer.json so repository can be used as replacement of zendframework/zend-diactoros:^2.2.1.Added ----- - Nothing. Changed ------- - Nothing. Deprecated ---------- - Nothing. Removed ------- - Nothing. Fixed ----- - #30 adds missing return st
return statements to the various src/functions/*.legacy.php function files to ensure they work correctly when used.Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.