$streams
$streams : array<mixed,\Psr\Http\Message\StreamInterface>
Reads from multiple streams, one after the other.
This is a read-only stream decorator.
$streams : array<mixed,\Psr\Http\Message\StreamInterface>
__construct(array<mixed,\Psr\Http\Message\StreamInterface> $streams = array())
| array<mixed,\Psr\Http\Message\StreamInterface> | $streams | Streams to decorate. Each stream must be readable. |
__toString() : string
Reads all data from the stream into a string, from the beginning to end.
This method MUST attempt to seek to the beginning of the stream before reading data and read the stream until the end is reached.
Warning: This could attempt to load a large amount of data into memory.
This method MUST NOT raise an exception in order to conform with PHP's string casting operations.
addStream(\Psr\Http\Message\StreamInterface $stream)
Add a stream to the AppendStream
| \Psr\Http\Message\StreamInterface | $stream | Stream to append. Must be readable. |
if the stream is not readable
getSize() : integer|null
Tries to calculate the size by adding the size of each stream.
If any of the streams do not return a valid number, then the size of the append stream cannot be determined and null is returned.
Returns the size in bytes if known, or null if unknown.
seek(integer $offset, integer $whence = SEEK_SET)
Attempts to seek to the given position. Only supports SEEK_SET.
| integer | $offset | Stream offset |
| integer | $whence | Specifies how the cursor position will be calculated
based on the seek offset. Valid values are identical to the built-in
PHP $whence values for |
read(integer $length) : string
Reads from all of the appended streams until the length is met or EOF.
| integer | $length | Read up to $length bytes from the object and return them. Fewer than $length bytes may be returned if underlying stream call returns fewer bytes. |
Returns the data read from the stream, or an empty string if no bytes are available.
getMetadata(string $key = null) : array|mixed|null
Get stream metadata as an associative array or retrieve a specific key.
The keys returned are identical to the keys returned from PHP's stream_get_meta_data() function.
| string | $key | Specific metadata to retrieve. |
Returns an associative array if no key is provided. Returns a specific key value if a key is provided and the value is found, or null if the key is not found.