socket_read

(PHP 4 >= 4.1.0, PHP 5, PHP 7)

socket_readЧитает строку максимальную длину байт из сокета

Описание

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

Функция socket_read() читает данные из ресурса сокета socket, созданного при помощи функций socket_create() или socket_accept().

Список параметров

socket

Действующий ресурс сокета, созданный при помощи функций socket_create() или socket_accept().

length

Максимальное количество байт для чтения определено параметром length. Как вариант вы можете использовать \r, \n, или \0 для окончания чтения (в зависимости от параметра type, см ниже).

type

Необязательный параметр type - это именованная константа:

  • PHP_BINARY_READ (По умолчанию) - используется системная функция recv(). Безопасно для чтения бинарных данных.
  • PHP_NORMAL_READ - чтение останавливается на \n или \r.

Возвращаемые значения

socket_read() возвращает данные в виде строки в случае успеха, или FALSE в случае ошибки (включая случай, когда удалённый хост закрыл соединение). Код ошибки может быть получен при помощи функции socket_last_error(). Этот код может быть передан функции socket_strerror() для получения текстового описания ошибки.

Замечание:

socket_read() возвращает строку нулевой длины (""), когда больше нет данных для чтения.

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

  • socket_accept() - Принимает соединение на сокете
  • socket_bind() - Привязывает имя к сокету
  • socket_connect() - Начинает соединение с сокетом
  • socket_listen() - Прослушивает входящие соединения на сокете
  • socket_last_error() - Возвращает последнюю ошибку на сокете
  • socket_strerror() - Возвращает строку, описывающую ошибку сокета
  • socket_write() - Запись в сокет