array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.socket-read.php', 1 => 'socket_read', ), 'up' => array ( 0 => 'ref.sockets.php', 1 => 'Функции сокета', ), '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' => 'ru', '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 — Читает строку максимальной длины байт из сокета
Функция socket_read() читает данные из экземпляра
Socket socket
, созданного при помощи
функций socket_create() или
socket_accept().
socket
Экземпляр Socket, созданный при помощи функций socket_create() или socket_accept().
length
Максимальное количество байт для чтения определено параметром
length
. Как вариант вы можете использовать
\r
, \n
,
или \0
для окончания чтения (в зависимости от параметра
mode
, смотрите ниже).
mode
Необязательный параметр mode
- это именованная константа:
PHP_BINARY_READ
(По умолчанию) - используется системная функция
recv()
. Безопасно для чтения бинарных данных.
PHP_NORMAL_READ
- чтение останавливается на
\n
или \r
.
socket_read() возвращает данные в виде строки в случае успешного выполнения,
или false
в случае возникновения ошибки (включая случай, когда удалённый хост закрыл
соединение). Код ошибки может быть получен при помощи функции
socket_last_error(). Этот код может быть передан функции
socket_strerror() для получения текстового описания ошибки.
Замечание:
socket_read() возвращает строку нулевой длины (""), когда больше нет данных для чтения.
Версия | Описание |
---|---|
8.0.0 |
socket теперь экземпляр класса Socket;
ранее был ресурсом (resource).
|