socket_create_listen

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

socket_create_listenAbre un socket en un puerto para aceptar conexiones

Descripción

socket_create_listen(int $port, int $backlog = SOMAXCONN): Socket|false

socket_create_listen() crea una nueva instancia de Socket, de tipo AF_INET, en espera en todas las interfaces locales, para el puerto port.

socket_create_listen() sirve para simplificar la creación de nuevos sockets destinados a estar en espera, y aceptar nuevas conexiones.

Parámetros

port

El puerto que debe ser escuchado en todas las interfaces.

backlog

El parámetro backlog define el tamaño máximo de la cola de conexiones en espera. SOMAXCONN puede ser utilizada como valor para el parámetro backlog. Consulte socket_listen() para más detalles.

Valores devueltos

socket_create_listen() devuelve una nueva instancia de Socket en caso de éxito y false en caso de error. El código de error generado puede ser obtenido llamando a la función socket_last_error(). Este código de error puede ser pasado a la función socket_strerror() para obtener un mensaje de error legible por humanos.

Historial de cambios

Versión Descripción
8.4.0 El valor por omisión es ahora SOMAXCONN. Anteriormente, era 128.
8.0.0 En caso de éxito, esta función devuelve ahora una instancia de Socket; anteriormente, se devolvía un resource.

Notas

Nota:

Si se desea crear un socket que solo escuche ciertas interfaces, debe utilizarse socket_create(), socket_bind() y socket_listen().

Ver también