Учебник РНР
НазадВперёд

socket_read

(PHP 4 >= 4.1.0)

socket_read - читает максимум length байтов из сокета.

Описание

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

Предупреждение!

Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск.

Функция socket_read() читает из сокета socket, созданного функцией socket_accept(), максимальное количество байтов length. В ином случае вы можете использовать \r, \n или \0 для окончания чтения (в зависимости от параметра type; см. ниже).

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

Примечание: socket_read() может возвратить строку нулевой длины, обозначающую конец соединения (т.е. удалённая точка закрыла соединения).

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

  • PHP_BINARY_READ - использует системный read(). Безопасно для чтения бинарных данных. (По умолчанию в PHP >= 4.1.0).

  • PHP_NORMAL_READ - чтение останавливается у \n или \r. (По умолчанию PHP <= 4.0.6).

См. также socket_accept(), socket_bind(), socket_connect(), socket_listen(), socket_last_error(), socket_strerror() и socket_write().


НазадОглавлениеВперёд
socket_listenВверхsocket_readv