socket_create_listen
(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)
socket_create_listen — Відкриває сокет на вказаному порту для отримання з'єднань
Опис
socket_create_listen(int $port, int $backlog = 128): Socket|false
socket_create_listen() створює новий екземпляр Socketтипа**AF_INET**, слушающий навсіх локальних інтерфейсів вказаний порт в очікуванні нових з'єднань.
Ця функція призначена для спрощення завдання створення нового сокету, який слухає порт для отримання нових з'єднань.
Список параметрів
port
Порт, який слід слухати на всіх інтерфейсах.
backlog
Параметрbacklog визначає максимальну довжину, до якої може зрости черга з'єднань, що очікують. . SOMAXCONN може бути переданий як параметр backlog, смотритеsocket_listen() для повнішої інформації.
Значення, що повертаються
socket_create_listen() повертає новий екземпляр Socket у разі успішного виконання або false у разі виникнення помилки. Код помилки можна отримати за допомогою функції socket_last_error(). Цей код може бути переданий функції socket_strerror() для отримання текстового опису помилки.
список змін
| Версия | Опис |
|---|---|
| 8.0.0 | У разі успішного виконання функція повертає екземпляр Socket; раніше повертався ресурс (resource). |
Примітки
Зауваження :
Якщо ви хочете створити сокет, який прослуховуватиме лише певний інтерфейс, вам потрібно використовувати функції socket_create() socket_bind() і socket_listen()
Дивіться також
- socket_create() - створює сокет (кінцеву точку для обміну інформацією)
- socket_create_pair() - Створює пару нерозрізнених сокетів та зберігає їх у масиві
- socket_bind() - Прив'язує ім'я до сокету
- socket_listen() - Прослуховує вхідні з'єднання на сокеті
- socket_last_error() - Повертає останню помилку на сокеті
- socket_strerror() - Повертає рядок, що описує помилку сокету