socket_read
Reads a maximum of length bytes from a socket
Description
stringsocket_read
resourcesocket
intlength
inttype
&warn.experimental.func;
The function socket_read reads from the socket
resource socket created by the
socket_create or
socket_accept functions. The maximum number of bytes read
is specified by the length parameter. Otherwise
you can use \r, \n, or \0 to end reading
(depending on the type parameter, see below).
socket_read returns the data as a string on success, or
&false; on error. The error code can be retrieved with socket_last_error.
This code may be passed to socket_strerror to get a textual
representation of the error.
socket_read may return a zero length string ("")
indicating the end of communication (i.e. the remote end point has
closed the connection).
Optional type parameter is a named constant:
PHP_BINARY_READ - use the system read() function.
Safe for reading binary data. (Default in PHP
>= 4.1.0)
PHP_NORMAL_READ - reading stops at \n or \r. (Default in PHP <= 4.0.6)
See also
socket_accept,
socket_bind,
socket_connect,
socket_listen,
socket_last_error,
socket_strerror and
socket_write.