socket_read

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

socket_readLee datos de un socket

Descripción

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

socket_read() lee datos desde la instancia de Socket socket, creada por socket_create() o socket_accept().

Parámetros

socket

Una instancia de Socket creada por socket_create() o socket_accept().

length

Lee un máximo de length bytes. De lo contrario, puede utilizarse \r, \n o \0 para terminar la lectura (según el valor elegido para mode, ver a continuación).

mode

El parámetro opcional mode puede tomar uno de los siguientes valores constantes:

  • PHP_BINARY_READ (Por omisión) - utiliza la función del sistema recv(). Capaz de leer datos binarios.
  • PHP_NORMAL_READ - la lectura se detiene en \n y \r

Valores devueltos

socket_read() devuelve los datos en forma de string en caso de éxito, y false en caso contrario (incluyendo si el host remoto ha cerrado la conexión). El código de error generado puede obtenerse llamando a la función socket_last_error(). Este código de error puede pasarse a la función socket_strerror() para obtener un mensaje de error legible por humanos.

Nota:

socket_read() devuelve un string de longitud cero (""), cuando ya no hay más datos para leer.

Historial de cambios

Versión Descripción
8.0.0 socket is a Socket instance now; previously, it was a resource.

Ver también