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

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