socket_create_listen

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

socket_create_listenОткрывает сокет на указанном порту для принятия соединений

Описание

socket_create_listen(int $port, int $backlog = SOMAXCONN): 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() - Возвращает строку, описывающую ошибку сокета