Учебник PHP

         

socket_write

(PHP 4 >= 4.1.0)

socket_write - записывает в сокет.

Описание

int socket_write (resource socket, string buffer [, int length])

Предупреждение!
Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск.

Функция socket_write() записывает в сокет socket из буфера buffer.

Необязательный параметр length может специфицировать альтернативную длину байтов, записываемых в сокет. Если параметр length больше длины буфера, он скрыто усекается до длины буфера.

Возвращает количество байтов, успешно записанных в сокет, или FALSE при ошибке. Код ошибки можно запросить функцией socket_last_error(). Этот код можно передать функции socket_strerror() для получения текстового объяснения ошибки.

Примечание: socket_write() не обязательно записывает все байты из данного буфера. В зависимости от сетевых буферов etc., записывается только определённое количество данных, даже один байт, даже если ваш буфер больше. Вы должны отследить, чтобы не забыть случайно, передачу остатка ваших данных.

Примечание: для socket_write() совершенно правильным будет возврат 0, что означает отсутствие записанных байтов. Используйте операцию === для проверки FALSE в случае ошибки.

См. также socket_accept(), socket_bind(), socket_connect(), socket_listen(), socket_read() и socket_strerror().

Содержание раздела