(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)
socket_listen — Espera una conexión en un socket
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
.
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 aSOMAXCONN
. En Windows, si la constanteSOMAXCONN
es pasada, el servicio responsable de los sockets elegirá un valor máximo razonable. No hay método para adivinar el valor realmente elegido.
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.
Versión | Descripción |
---|---|
8.0.0 |
socket is a Socket instance now;
previously, it was a resource.
|