Documentation

EntityBodyInterface extends StreamInterface
in

Entity body used with an HTTP request or response

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
compress()  : bool
If the stream is readable, compress the data in the stream using deflate compression. The uncompressed stream is then closed, and the compressed stream then becomes the wrapped 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
getContentEncoding()  : bool|string
Get the Content-Encoding of the EntityBody
getContentLength()  : int|bool
Get the Content-Length of the entity body if possible (alias of getSize)
getContentMd5()  : bool|string
Get an MD5 checksum of the stream's contents
getContentType()  : string|null
Guess the Content-Type of a local stream
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
setRewindFunction()  : self
Specify a custom callback used to rewind a non-seekable stream. This can be useful entity enclosing requests that are redirected.
setSize()  : self
Specify the size of the stream in bytes
setStream()  : self
Set the stream that is wrapped by the object
uncompress()  : bool
Decompress a deflated string. Once uncompressed, the uncompressed string is then used as the wrapped stream.
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

compress()

If the stream is readable, compress the data in the stream using deflate compression. The uncompressed stream is then closed, and the compressed stream then becomes the wrapped stream.

public compress([string $filter = 'zlib.deflate' ]) : bool
Parameters
$filter : string = 'zlib.deflate'

Compression filter

Return values
bool —

Returns TRUE on success or FALSE on failure

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

getContentEncoding()

Get the Content-Encoding of the EntityBody

public getContentEncoding() : bool|string
Return values
bool|string

getContentLength()

Get the Content-Length of the entity body if possible (alias of getSize)

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

Returns the Content-Length or false on failure

getContentMd5()

Get an MD5 checksum of the stream's contents

public getContentMd5([bool $rawOutput = false ][, bool $base64Encode = false ]) : bool|string
Parameters
$rawOutput : bool = false

Whether or not to use raw output

$base64Encode : bool = false

Whether or not to base64 encode raw output (only if raw output is true)

Return values
bool|string —

Returns an MD5 string on success or FALSE on failure

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

setRewindFunction()

Specify a custom callback used to rewind a non-seekable stream. This can be useful entity enclosing requests that are redirected.

public setRewindFunction(mixed $callable) : self
Parameters
$callable : mixed

Callable to invoke to rewind a non-seekable stream. The callback must accept an EntityBodyInterface object, perform the rewind if possible, and return a boolean representing whether or not the rewind was successful.

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

uncompress()

Decompress a deflated string. Once uncompressed, the uncompressed string is then used as the wrapped stream.

public uncompress([string $filter = 'zlib.inflate' ]) : bool
Parameters
$filter : string = 'zlib.inflate'

De-compression filter

Return values
bool —

Returns TRUE on success or FALSE on failure

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