socket_read
(PHP 4 >= 4.1.0, PHP 5, PHP 7)
socket_read — Читает строку максимальную длину байт из сокета
Описание
$socket
, int $length
, int $type
= PHP_BINARY_READ
) : string
Функция 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() возвращает строку нулевой длины (""), когда больше нет данных для чтения.
Смотрите также
- socket_accept() - Принимает соединение на сокете
- socket_bind() - Привязывает имя к сокету
- socket_connect() - Начинает соединение с сокетом
- socket_listen() - Прослушивает входящие соединения на сокете
- socket_last_error() - Возвращает последнюю ошибку на сокете
- socket_strerror() - Возвращает строку, описывающую ошибку сокета
- socket_write() - Запись в сокет