socket_read

(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)

socket_read — Читає рядок максимальну довжину байт із сокету

Опис

socket_read(Socket $socket, int $length, int $mode = PHP_BINARY_READ): string|false

Функция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).

Дивіться також

• socket_accept() - приймає з'єднання на сокеті
• socket_bind() - Прив'язує ім'я до сокету
• socket_connect() - Починає з'єднання із сокетом
• socket_listen() - Прослуховує вхідні з'єднання на сокеті
• socket_last_error() - Повертає останню помилку на сокеті
• socket_strerror() - Повертає рядок, що описує помилку сокету
• socket_write() - Запис у сокет