(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)
socket_write — Запись в сокет
Функция socket_write() записывает в сокет
socket
данные из указанного буфера
data
.
socket
data
Буфер, который будет записан.
length
Необязательный параметр length
может указывать
другое число байт, записываемых в сокет. Если это число
больше, чем длина буфера, оно будет молча урезано до длины
буфера.
Возвращает количество байт, успешно записанных в сокет или false
, если возникла ошибка.
Код ошибки может быть получен при помощи функции
socket_last_error(). Этот код может быть передан функции
socket_strerror() для получения текстового описания
ошибки.
Замечание:
Совершенно нормально для функции socket_write() возвращать ноль, что означает, что ни одного байта не было записано. Пожалуйста, используйте оператор
===
для проверки значения наfalse
в случае возникновения ошибки.
Версия | Описание |
---|---|
8.0.0 |
socket теперь экземпляр класса Socket;
ранее был ресурсом (resource).
|
8.0.0 |
length теперь допускает значение null.
|
Замечание:
socket_write() не обязательно записывает все байты из указанного буфера. Нормально то, что, в зависимости от сетевых буферов и т. д., только некоторое количество данных, даже один байт, будет записан, хотя ваш буфер больше. Вы должны следить за тем, чтобы непреднамеренно не забыть передать остаток ваших данных.