socket_connect

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

socket_connect — Починає з'єднання з сокетом

Опис

socket_connect(Socket $socket, string $address, ?int $port = null): bool

Ініціалізує з'єднання з адресою address, використовуючи екземпляр Socket socket, який має бути екземпляром Socket, створеним за допомогою функції socket_create()

Список параметрів

socket

Екземпляр Socket, створений за допомогою socket_create()

address

Параметрaddress може бути IPv4-адресою в записі, розділеною точками (наприклад, 127.0.0.1), якщо параметр socketравен**AF_INET, правильна IPv6-адреса (наприклад, ::1), якщо включена підтримка IPv6 та параметр socketравенAF_INET6** або шлях до файлу доменного сокету Unix, якщо використовується сімейство сокетів AF_UNIX

port

Параметрport використовується та обов'язковий тільки в тому випадку, якщо відбувається з'єднання з сокетом AF_INET або AF_INET6, і він вказує порт на віддаленому хості, до якого має бути створено з'єднання.

Значення, що повертаються

Повертає true у разі успішного виконання або false у разі виникнення помилки. Код помилки можна отримати за допомогою функції socket_last_error(). Цей код може бути потім переданий функції socket_strerror() для отримання текстового опису помилки.

Зауваження :

Якщо неблокуючий сокет, то ця функція повертає false з помилкою Operation now in progress

список змін

Версия	Опис
8.0.0	socket тепер екземпляр класу Socket; раніше був ресурсом (resource).
8.0.0	port тепер допускає значення null.

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

• socket_bind() - Прив'язує ім'я до сокету
• socket_listen() - Прослуховує вхідні з'єднання на сокеті
• socket_create() - створює сокет (кінцеву точку для обміну інформацією)
• socket_last_error() - Повертає останню помилку на сокеті
• socket_strerror() - Повертає рядок, що описує помилку сокету