socket_read
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().