socket_read

(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)

socket_readReads a maximum of length bytes from a socket

Descrição

socket_read(Socket$socket, int$length, int$mode = PHP_BINARY_READ): string|false

The function socket_read() reads from the Socket instance socket created by the socket_create() or socket_accept() functions.

Parâmetros

socket

A Socket instance created with socket_create() or socket_accept().

length

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 mode parameter, see below).

mode

Optional mode parameter is a named constant:

Valor Retornado

socket_read() returns the data as a string on success, or false on error (including if the remote host has closed the connection). 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.

Nota:

socket_read() returns a zero length string ("") when there is no more data to read.

Registro de Alterações

VersãoDescrição
8.0.0 O parâmetro socket agora espera uma instância de Socket; anteriormente, um resource era esperado.

Veja Também

To Top