file_get_meta_dataRetrieves header/meta data from streams/file pointersDescriptionarrayfile_get_meta_dataresourcestream
Returns information about an existing stream.
The stream can be any stream created by fopen,
fsockopen and pfsockopen.
The result array contains the following items:
timed_out (bool) - &true; if the stream
timed out while waiting for data on the last call to
fread or fgets.
blocked (bool) - &true; if the stream is
in blocking IO mode. See socket_set_blocking.
eof (bool) - &true; if the stream has reached
end-of-file. Note that for socket streams this member can be &true;
even when unread_bytes is non-zero. To
determine if there is more data to be read, use
feof instead of reading this item.
unread_bytes (int) - the number of bytes
currently contained in the read buffer.
The following items were added in PHP 4.3:
stream_type (string) - a label describing
the underlying implementation of the stream.
wrapper_type (string) - a label describing
the protocol wrapper implementation layered over the stream.
See for more information about wrappers.
wrapper_data (mixed) - wrapper specific
data attached to this stream. See for
more information about wrappers and their wrapper data.
filters (array) - and array containing
the names of any filters that have been stacked onto this stream.
Filters are currently undocumented.
This function was introduced in PHP 4.3, but prior to this version,
socket_get_status could be used to retrieve
the first four items, for socket based streams only.
In PHP 4.3 and later,
socket_get_status is an alias for this function.
This function does NOT work on sockets created by the Socket extension.