(PHP 4 >= 4.1.0, PHP 5, PHP 7)
socket_read — Lee un máximo de longitud de bytes desde un socket
$socket
, int $length
[, int $type
= PHP_BINARY_READ
] ) : string
La función socket_read() lee desde un recurso
socket socket
creado por las funciones
socket_create() o
socket_accept().
socket
Un recurso socket válido creado con socket_create() o socket_accept().
length
El número máximo de bytes leidos es especificado 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.
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.