array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.socket-read.php', 1 => 'socket_read', ), 'up' => array ( 0 => 'ref.sockets.php', 1 => 'Funções para 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' => 'en', 'path' => 'reference/sockets/functions/socket-read.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)
socket_read — Reads a maximum of length bytes from a socket
The function socket_read() reads from the Socket instance
socket
created by the
socket_create() or
socket_accept() functions.
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:
PHP_BINARY_READ
(Default) - use the system
recv()
function. Safe for reading binary data.
PHP_NORMAL_READ
- reading stops at
\n
or \r
.
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.
Versão | Descrição |
---|---|
8.0.0 |
O parâmetro socket agora espera uma instância de Socket;
anteriormente, um resource era esperado.
|