guzzlehttp/psr7

Guzzle PSR-7 2.0 requires PHP ^7.2.5 || ^8.0.

Key dependency changes:

• ralouphie/getallheaders v2 support is dropped; 2.0 requires ^3.0.
• psr/http-factory:^1.0 is now required because 2.0 includes GuzzleHttp\ Psr7\\HttpFactory (a PSR-17 implementation).

To use this package for creating or inspecting PSR-7 messages (requests, responses, URIs, uploaded files, and streams), install it using Composer.

composer require guzzlehttp/psr7

In version 3.0, UriResolver::relativize() has been updated to return a network-path reference (e.g., //example.com) when the target URI has the same authority as the base URI but an empty path that cannot be expressed as a path reference. This ensures a documented round-trip guarantee.

$base = new Uri('http://example.com/a');
$target = new Uri('http://example.com');

// 2.x
(string) UriResolver::relativize($base, $target); // ../
// which resolved back to http://example.com/

// 3.0
(string) UriResolver::relativize($base, $target); // //example.com

Significant changes have been made to MultipartStream to align with RFC 7578:

• Content-Length: Default Content-Length headers are no longer added to individual parts. If a non-standard peer requires them, you must pass them explicitly in the headers array.
• Escaping: Content-Disposition name and filename parameters are now escaped (e.g., " becomes %22).
• Custom Boundaries: Explicit boundaries are validated against RFC 2046. The string '0' is now treated as a literal custom boundary. To use a generated random boundary, pass null or omit the argument.

Example: Providing explicit Content-Length

$body = new MultipartStream([
    [
        'name' => 'foo',
        'contents' => 'bar',
        'headers' => ['Content-Length' => '3'],
    ],
]);

When creating streams via Utils::streamFor() using an Iterator, note the following changes in 3.0:

• EOF Signaling: Iterator exhaustion is now the only way to signal EOF. Yielding false, null, or an empty string '' will no longer stop the stream; these are treated as zero-length chunks and are skipped.
• Validation: Utils::streamFor() validates yielded values. Non-finite floats, arrays, resources, and non-stringable objects will throw an UnexpectedValueException when the stream is read.

Example Migration:

// Before: yielding false or null could stop an iterator-backed stream early.
$stream = Utils::streamFor(new ArrayIterator([false, 'body']));

// After: false and null are skipped chunks. End the iterator to signal EOF.
$stream = Utils::streamFor(new ArrayIterator(['body']));

The global function API was removed in 2.0.0. Replace namespaced function calls with the corresponding static methods in the GuzzleHttp\\Psr7 namespace.

// Before:
use function GuzzleHttp\\Psr7\\stream_for;
$stream = stream_for('body');

// After:
use GuzzleHttp\\Psr7\\Utils;
$stream = Utils::streamFor('body');

When using PumpStream, the source callable must now return a non-empty string to produce data.

• To signal EOF: Return false or null.
• To signal 'temporarily no data': Do not return an empty string '' (this now throws a RuntimeException). Instead, wait until data is available and return a non-empty string.
• Avoid infinite loops: Returning an empty string no longer triggers a retry; it results in an error.

Several stream classes are now declared final in 2.0 and cannot be extended via inheritance:

• AppendStream, BufferStream, CachingStream, DroppingStream, FnStream, InflateStream, LazyOpenStream, LimitStream, MultipartStream, NoSeekStream, PumpStream, StreamWrapper.

Solution: Replace inheritance with composition. For custom streams, implement Psr\Http\Message\StreamInterface directly or use GuzzleHttp\Psr7\StreamDecoratorTrait in your own class.

The methods Uri::resolve() and Uri::removeDotSegments() were removed in 2.0. Use UriResolver instead.

// Before:
$resolved = Uri::resolve($base, '../path');
$path = Uri::removeDotSegments('/a/../b');

// After:
use GuzzleHttp\\Psr7\\UriResolver;
use GuzzleHttp\\Psr7\\Utils;

$resolved = UriResolver::resolve($base, Utils::uriFor('../path'));
$path = UriResolver::removeDotSegments('/a/../b');