socket_listen

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

socket_listenEspera una conexión en un socket

Descripción

socket_listen(Socket $socket, int $backlog = 0): bool

Una vez que el socket socket ha sido creado con la función socket_create() y vinculado a un nombre con la función socket_bind(), puede ponerse en espera de la conexión entrante.

socket_listen() solo funciona con sockets de tipo SOCK_STREAM y SOCK_SEQPACKET.

Parámetros

socket

Una instancia de Socket creada por socket_create() o socket_addrinfo_bind().

backlog

Un número máximo de backlog conexiones serán puestas en espera de procesamiento. Si una solicitud de conexión llega y la cola está llena, el cliente recibirá un error indicando ECONNREFUSED, o, si el protocolo de soporte acepta retransmisiones, la solicitud será ignorada para que los intentos posteriores finalmente tengan éxito.

Nota:

El número máximo pasado en el parámetro backlog depende principalmente de la plataforma de soporte. En Linux, se trunca automáticamente a SOMAXCONN. En Windows, si la constante SOMAXCONN es pasada, el servicio responsable de los sockets elegirá un valor máximo razonable. No hay método para adivinar el valor realmente elegido.

Valores devueltos

Devuelve true en caso de éxito o false en caso de error. El código de error generado puede obtenerse llamando a la función socket_last_error(). Este código de error puede pasarse a la función socket_strerror() para obtener un mensaje de error legible por humanos.

Historial de cambios

Versión Descripción
8.0.0 socket is a Socket instance now; previously, it was a resource.

Ver también