array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.socket-read.php', 1 => 'socket_read', 2 => 'Считывает из сокета максимальное количество байтов', ), 'up' => array ( 0 => 'ref.sockets.php', 1 => 'Функции модуля 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' => 'ru', '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 — Считывает из сокета максимальное количество байтов

Описание

socket_read(Socket $socket, int $length, int $mode = PHP_BINARY_READ): string|false

Функция 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.

Смотрите также