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