Class Stream
PHP stream implementation
- Guzzle\Stream\Stream implements Guzzle\Stream\StreamInterface
Direct known subclasses
Methods summary
-
public
__construct ( resource $stream, int $size = null )
-
public
__destruct ( )
Closes the stream when the helper is destructed
-
public
__toString ( )
Convert the stream to a string if the stream is readable and the stream is seekable.
-
public
close ( )
Close the underlying stream
-
public static
getHash ( Guzzle\Stream\StreamInterface $stream, string $algo, bool $rawOutput = false )
Calculate a hash of a Stream
-
public
getMetaData ( string $key = null )
Get stream metadata
-
public
getStream ( )
Get the stream resource
-
public
setStream ( resource $stream, int $size = null )
Set the stream that is wrapped by the object
-
public
detachStream ( )
Detach the current stream resource
-
public
getWrapper ( )
Get the stream wrapper type
-
public
getWrapperData ( )
Wrapper specific data attached to this stream.
-
public
getStreamType ( )
Get a label describing the underlying implementation of the stream
-
public
getUri ( )
Get the URI/filename associated with this stream
-
public
getSize ( )
Get the size of the stream if able
-
public
isReadable ( )
Check if the stream is readable
-
public
isRepeatable ( )
Check if the stream is repeatable
-
public
isWritable ( )
Check if the stream is writable
-
public
isConsumed ( )
Check if the stream has been consumed
-
public
feof ( )
Alias of isConsumed
-
public
isLocal ( )
Check if the stream is a local stream vs a remote stream
-
public
isSeekable ( )
Check if the string is repeatable
-
public
setSize ( int $size )
Specify the size of the stream in bytes
-
public
seek ( int $offset, int $whence = SEEK_SET )
Seek to a position in the stream
-
public
read ( int $length )
Read data from the stream
-
public
write ( string $string )
Write data to the stream
-
public
ftell ( )
Returns the current position of the file read/write pointer
-
public
rewind ( )
Rewind to the beginning of the stream
-
public
readLine ( int $maxLength = null )
Read a line from the stream up to the maximum allowed buffer length
-
public
setCustomData ( string $key, mixed $value )
Set custom data on the stream
-
public
getCustomData ( string $key )
Get custom data from the stream
-
protected
rebuildCache ( )
Reprocess stream metadata
Methods detail
Parameters
- $stream
resource
$stream Stream resource to wrap- $size
integer
$size Size of the stream in bytes. Only pass if the size cannot be obtained from the stream.
Throws
Closes the stream when the helper is destructed
Convert the stream to a string if the stream is readable and the stream is seekable.
Returns
string
Implementation of
public static
boolean|string
getHash( Guzzle\Stream\StreamInterface
$stream, string $algo, boolean $rawOutput = false )
Calculate a hash of a Stream
Parameters
- $stream
Guzzle\Stream\StreamInterface
$stream Stream to calculate the hash for- $algo
string
$algo Hash algorithm (e.g. md5, crc32, etc)- $rawOutput
boolean
$rawOutput Whether or not to use raw output
Returns
boolean|string
Returns false on failure or a hash string on success
Get stream metadata
Parameters
- $key
string
$key Specific metadata to retrieve
Returns
array|mixed|null
Implementation of
Get the stream resource
Returns
resource
Implementation of
Set the stream that is wrapped by the object
Parameters
- $stream
resource
$stream Stream resource to wrap- $size
integer
$size Size of the stream in bytes. Only pass if the size cannot be obtained from the stream.
Returns
Implementation of
Detach the current stream resource
Returns
Implementation of
Get the stream wrapper type
Returns
string
Implementation of
Wrapper specific data attached to this stream.
Returns
array
Implementation of
Get a label describing the underlying implementation of the stream
Returns
string
Implementation of
Get the URI/filename associated with this stream
Returns
string
Implementation of
Get the size of the stream if able
Returns
integer|boolean
Implementation of
Check if the stream is readable
Returns
boolean
Implementation of
Check if the stream is repeatable
Returns
boolean
Implementation of
Check if the stream is writable
Returns
boolean
Implementation of
Check if the stream has been consumed
Returns
boolean
Implementation of
Check if the stream is a local stream vs a remote stream
Returns
boolean
Implementation of
Check if the string is repeatable
Returns
boolean
Implementation of
Specify the size of the stream in bytes
Parameters
- $size
integer
$size Size of the stream contents in bytes
Returns
Implementation of
Seek to a position in the stream
Parameters
- $offset
integer
$offset Stream offset- $whence
integer
$whence Where the offset is applied
Returns
boolean
Returns TRUE on success or FALSE on failure
Link
Implementation of
Read data from the stream
Parameters
- $length
integer
$length Up to length number of bytes read.
Returns
string|boolean
Returns the data read from the stream or FALSE on failure or EOF
Implementation of
Write data to the stream
Parameters
- $string
string
$string The string that is to be written.
Returns
integer|boolean
Returns the number of bytes written to the stream on success or FALSE on failure.
Implementation of
Returns the current position of the file read/write pointer
Returns
integer|boolean
Returns the position of the file pointer or false on error
Implementation of
Rewind to the beginning of the stream
Returns
boolean
Returns true on success or false on failure
Implementation of
Read a line from the stream up to the maximum allowed buffer length
Parameters
- $maxLength
integer
$maxLength Maximum buffer length
Returns
string|boolean
Implementation of
Set custom data on the stream
Parameters
- $key
string
$key Key to set- $value
mixed
$value Value to set
Returns
Implementation of
Get custom data from the stream
Parameters
- $key
string
$key Key to retrieve
Returns
null|mixed
Implementation of
Reprocess stream metadata
Magic methods summary
Constants summary
string |
STREAM_TYPE |
'stream_type' |
|
string |
WRAPPER_TYPE |
'wrapper_type' |
|
string |
IS_LOCAL |
'is_local' |
|
string |
IS_READABLE |
'is_readable' |
|
string |
IS_WRITABLE |
'is_writable' |
|
string |
SEEKABLE |
'seekable' |
Properties summary
protected
resource
|
$stream |
#
Stream resource |
protected
integer
|
$size |
#
Size of the stream contents in bytes |
protected
array
|
$cache |
#
Stream cached data |
protected
array
|
$customData |
#
Custom stream data |
protected static
array
|
$readWriteHash |
#
Hash table of readable and writeable stream types for fast lookups |