array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.socket-read.php', 1 => 'socket_read', 2 => 'Lee datos de un socket', ), 'up' => array ( 0 => 'ref.sockets.php', 1 => 'Funciones de Socket', ), 'prev' => array ( 0 => 'function.socket-listen.php', 1 => 'socket_listen', ), 'next' => array ( 0 => 'function.socket-recv.php', 1 => 'socket_recv', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/sockets/functions/socket-read.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

socket_read

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

socket_read — Lee 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 ahora es una instancia de Socket ; anteriormente, era un resource.

Ver también