(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)
socket_read — Считывает из сокета максимальное количество байтов
Функция socket_read() считывает данные из сокета, который указали
в параметре socket экземпляром класса Socket,
который создали функциями socket_create()
или socket_accept().
socketЭкземпляр класса Socket, который создали функциями socket_create() или socket_accept().
length
Параметр length указывает максимальное количество байтов,
которое считает функция. Другой способ закончить считывание —
указать символы \r, \n
или \0 (в зависимости от параметра
mode, смотрите ниже).
mode
Необязательный параметр mode — именованная константа:
PHP_BINARY_READ (по умолчанию) — вызывает системную функцию
recv(). Режим безопасен при чтении двоичных данных.
PHP_NORMAL_READ — останавливает считывание
на символах \n или \r.
Функция socket_read() возвращает данные в виде строки в случае успешного выполнения,
или false, если возникла ошибка (включая случай, когда удалённый хост закрыл
соединение). Код ошибки возвращает функция socket_last_error().
Этот код передают в функцию socket_strerror(),
чтобы получить текстовое описание ошибки.
Замечание:
Функция socket_read() возвращает строку нулевой длины (""), когда данных для чтения не осталось.
| Версия | Описание |
|---|---|
| 8.0.0 |
Теперь параметр socket ожидает экземпляр класса Socket;
раньше параметр ожидал ресурс (resource).
|