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


(PHP 4 >= 4.1.0, PHP 5)

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

Описание

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

Функция 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() возвращает строку нулевой длины ("") когда больше нет данных для чтения.

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