Documentation

StreamInterface
in

OO interface to PHP streams

Table of Contents

Methods

__toString()  : string
Convert the stream to a string if the stream is readable and the stream is seekable.
close()  : mixed
Close the underlying stream
detachStream()  : self
Detach the current stream resource
feof()  : bool
Alias of isConsumed
ftell()  : int|bool
Returns the current position of the file read/write pointer
getCustomData()  : null|mixed
Get custom data from the stream
getMetaData()  : array<string|int, mixed>|mixed|null
Get stream metadata
getSize()  : int|bool
Get the size of the stream if able
getStream()  : resource
Get the stream resource
getStreamType()  : string
Get a label describing the underlying implementation of the stream
getUri()  : string
Get the URI/filename associated with this stream
getWrapper()  : string
Get the stream wrapper type
getWrapperData()  : array<string|int, mixed>
Wrapper specific data attached to this stream.
isConsumed()  : bool
Check if the stream has been consumed
isLocal()  : bool
Check if the stream is a local stream vs a remote stream
isReadable()  : bool
Check if the stream is readable
isRepeatable()  : bool
Check if the stream is repeatable
isSeekable()  : bool
Check if the string is repeatable
isWritable()  : bool
Check if the stream is writable
read()  : string|bool
Read data from the stream
readLine()  : string|bool
Read a line from the stream up to the maximum allowed buffer length
rewind()  : bool
Rewind to the beginning of the stream
seek()  : bool
Seek to a position in the stream
setCustomData()  : self
Set custom data on the stream
setSize()  : self
Specify the size of the stream in bytes
setStream()  : self
Set the stream that is wrapped by the object
write()  : int|bool
Write data to the stream

Methods

__toString()

Convert the stream to a string if the stream is readable and the stream is seekable.

public __toString() : string
Return values
string

detachStream()

Detach the current stream resource

public detachStream() : self
Return values
self

ftell()

Returns the current position of the file read/write pointer

public ftell() : int|bool
Return values
int|bool —

Returns the position of the file pointer or false on error

getCustomData()

Get custom data from the stream

public getCustomData(string $key) : null|mixed
Parameters
$key : string

Key to retrieve

Return values
null|mixed

getMetaData()

Get stream metadata

public getMetaData([string $key = null ]) : array<string|int, mixed>|mixed|null
Parameters
$key : string = null

Specific metadata to retrieve

Return values
array<string|int, mixed>|mixed|null

getSize()

Get the size of the stream if able

public getSize() : int|bool
Return values
int|bool

getStream()

Get the stream resource

public getStream() : resource
Return values
resource

getStreamType()

Get a label describing the underlying implementation of the stream

public getStreamType() : string
Return values
string

getUri()

Get the URI/filename associated with this stream

public getUri() : string
Return values
string

getWrapper()

Get the stream wrapper type

public getWrapper() : string
Return values
string

getWrapperData()

Wrapper specific data attached to this stream.

public getWrapperData() : array<string|int, mixed>
Return values
array<string|int, mixed>

isConsumed()

Check if the stream has been consumed

public isConsumed() : bool
Return values
bool

isLocal()

Check if the stream is a local stream vs a remote stream

public isLocal() : bool
Return values
bool

isReadable()

Check if the stream is readable

public isReadable() : bool
Return values
bool

isRepeatable()

Check if the stream is repeatable

public isRepeatable() : bool
Return values
bool

isSeekable()

Check if the string is repeatable

public isSeekable() : bool
Return values
bool

isWritable()

Check if the stream is writable

public isWritable() : bool
Return values
bool

read()

Read data from the stream

public read(int $length) : string|bool
Parameters
$length : int

Up to length number of bytes read.

Return values
string|bool —

Returns the data read from the stream or FALSE on failure or EOF

readLine()

Read a line from the stream up to the maximum allowed buffer length

public readLine([int $maxLength = null ]) : string|bool
Parameters
$maxLength : int = null

Maximum buffer length

Return values
string|bool

rewind()

Rewind to the beginning of the stream

public rewind() : bool
Return values
bool —

Returns true on success or false on failure

seek()

Seek to a position in the stream

public seek(int $offset[, int $whence = SEEK_SET ]) : bool
Parameters
$offset : int

Stream offset

$whence : int = SEEK_SET

Where the offset is applied

Tags
link
http://www.php.net/manual/en/function.fseek.php
Return values
bool —

Returns TRUE on success or FALSE on failure

setCustomData()

Set custom data on the stream

public setCustomData(string $key, mixed $value) : self
Parameters
$key : string

Key to set

$value : mixed

Value to set

Return values
self

setSize()

Specify the size of the stream in bytes

public setSize(int $size) : self
Parameters
$size : int

Size of the stream contents in bytes

Return values
self

setStream()

Set the stream that is wrapped by the object

public setStream(resource $stream[, int $size = null ]) : self
Parameters
$stream : resource

Stream resource to wrap

$size : int = null

Size of the stream in bytes. Only pass if the size cannot be obtained from the stream.

Return values
self

write()

Write data to the stream

public write(string $string) : int|bool
Parameters
$string : string

The string that is to be written.

Return values
int|bool —

Returns the number of bytes written to the stream on success or FALSE on failure.


        

        
    




    

    

                                

                

                            
    

        On this page

        
    


                

                            

            

    

        

            
Search results