socket_read

(PHP 4 >= 4.1.0, PHP 5)

socket_read — Lee un máximo de longitud de bytes desde un socket

Descripción

string socket_read ( resource $socket , int $length [, int $type = PHP_BINARY_READ ] )

La función socket_read() lee desde un recurso socket socket creado por las funciones socket_create() o socket_accept().

Parámetros

socket

Un recurso socket válido creado con socket_create() o socket_accept().

length

El número máximo de bytes leidos es espeicificado por el parámetro length. Por lo demás se puede usar \r, \n, o \0 para finalizar la lectura (dependiendo del parámetro type, véase abajo).

type

EL parámetro opcional type es una constante nominada:

  • PHP_BINARY_READ (Predeterminada) - usa la función del sistema recv(). Segura para la lectura de información binaria.
  • PHP_NORMAL_READ - la lectura se detiene en \n o \r.

Valores devueltos

socket_read() devuelve la información como cadena en caso de éxito, o FALSE en caso de error (incluyendo si el host remoto cerró la conexión). El código de error real se puede recuperar llamando a socket_last_error(). Este código se puede pasar a socket_strerror() para obtener una explicación textual del error.

Nota:

socket_read() devuelve una cadena de longitud cero ("") cuando no hay más información que leer.

Ver también