\GuzzleHttp\Psr7Stream

PHP stream implementation.

Summary

Methods
Properties
Constants
__construct()
__destruct()
__toString()
getContents()
close()
detach()
getSize()
isReadable()
isWritable()
isSeekable()
eof()
tell()
rewind()
seek()
read()
write()
getMetadata()
No public properties found
READABLE_MODES
WRITABLE_MODES
No protected methods found
No protected properties found
N/A
No private methods found
$stream
$size
$seekable
$readable
$writable
$uri
$customMetadata
N/A

Constants

READABLE_MODES

READABLE_MODES = '/r|a\\+|ab\\+|w\\+|wb\\+|x\\+|xb\\+|c\\+|cb\\+/' : string

Resource modes.

WRITABLE_MODES

WRITABLE_MODES = '/a|w|r\\+|rb\\+|rw|x|c/'

Properties

$stream

$stream

$size

$size

$seekable

$seekable

$readable

$readable

$writable

$writable

$uri

$uri

$customMetadata

$customMetadata

Methods

__construct()

__construct(resource  $stream, array  $options = []) : mixed

This constructor accepts an associative array of options.

  • size: (int) If a read stream would otherwise have an indeterminate size, but the size is known due to foreknowledge, then you can provide that size, in bytes.
  • metadata: (array) Any additional metadata to return when the metadata of the stream is accessed.

Parameters

resource $stream

Stream resource to wrap.

array $options

Associative array of options.

Throws

\InvalidArgumentException

if the stream is not a stream resource

Returns

mixed —

__destruct()

__destruct() : mixed

Closes the stream when the destructed

Returns

mixed —

__toString()

__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.

Returns

string —

getContents()

getContents() : string

Returns the remaining contents in a string

Returns

string —

close()

close() : void

Closes the stream and any underlying resources.

detach()

detach() : resource|null

Separates any underlying resources from the stream.

After the stream has been detached, the stream is in an unusable state.

Returns

resource|null —

Underlying PHP stream, if any

getSize()

getSize() : int|null

Get the size of the stream if known.

Returns

int|null —

Returns the size in bytes if known, or null if unknown.

isReadable()

isReadable() : bool

Returns whether or not the stream is readable.

Returns

bool —

isWritable()

isWritable() : bool

Returns whether or not the stream is writable.

Returns

bool —

isSeekable()

isSeekable() : bool

Returns whether or not the stream is seekable.

Returns

bool —

eof()

eof() : bool

Returns true if the stream is at the end of the stream.

Returns

bool —

tell()

tell() : int

Returns the current position of the file read/write pointer

Returns

int —

Position of the file pointer

rewind()

rewind() : mixed

Seek to the beginning of the stream.

If the stream is not seekable, this method will raise an exception; otherwise, it will perform a seek(0).

Returns

mixed —

seek()

seek(mixed  $offset, mixed  $whence = SEEK_SET) : mixed

Seek to a position in the stream.

Parameters

mixed $offset

Stream offset

mixed $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 fseek(). SEEK_SET: Set position equal to offset bytes SEEK_CUR: Set position to current location plus offset SEEK_END: Set position to end-of-stream plus offset.

Returns

mixed —

read()

read(mixed  $length) : string

Read data from the stream.

Parameters

mixed $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

string —

Returns the data read from the stream, or an empty string if no bytes are available.

write()

write(mixed  $string) : int

Write data to the stream.

Parameters

mixed $string

The string that is to be written.

Returns

int —

Returns the number of bytes written to the stream.

getMetadata()

getMetadata(mixed  $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.

Parameters

mixed $key

Specific metadata to retrieve.

Returns

array|mixed|null —

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.