socket_bind
(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)
socket_bind — Прив'язує ім'я до сокету
Опис
socket_bind(Socket $socket, string $address, int $port = 0): bool
Прив'язує ім'я, вказане у параметрі address, к сокету, описанному в параметреsocket. Це має бути зроблено, перш ніж з'єднання встановлено за допомогою функції socket_connect() або socket_listen()
Список параметрів
socket
Екземпляр Socket, створений за допомогою функції socket_create()
address
Якщо сокет із сімейства AF_INET, то параметрaddress має бути IP-адресою в записі, розділеному точками (наприклад, 127.0.0.1
Якщо сокет із сімейства AF_UNIX, то параметрaddress - це шлях до доменного сокету Unix (наприклад, /tmp/my.sock).
port(Optional)
Параметрport використовується лише коли ім'я прив'язується до сокету AF_INET, та вказує порт, на якому будуть слухатися з'єднання.
Значення, що повертаються
Повертає true у разі успішного виконання або **false**в случае возникновения ошибки.
Код помилки можна отримати за допомогою функції socket_last_error(). Цей код може бути переданий функції socket_strerror() для отримання текстового опису помилки.
список змін
| Версия | Опис |
|---|---|
| 8.0.0 | socket тепер екземпляр класу Socket; раніше був ресурсом (resource). |
Приклади
Приклад #1 Использование функцииsocket_bind()для установки адреса источника
Примітки
Зауваження :
Ця функція має бути застосована на сокеті перед викликом socket_connect()
Зауваження :
Примечание по совместимости с Windows 9x/ME: Функцияsocket_last_error() може повертати неправильний код помилки при спробі зв'язати з сокетом неправильну адресу, яка не належить вашій машині.
Дивіться також
- socket_connect() - Починає з'єднання із сокетом
- socket_listen() - Прослуховує вхідні з'єднання на сокеті
- socket_create() - створює сокет (кінцеву точку для обміну інформацією)
- socket_last_error() - Повертає останню помилку на сокеті
- socket_strerror() - Повертає рядок, що описує помилку сокету