(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.
Esta función retorna true
en caso de éxito o false
si ocurre un 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 ahora es una instancia de Socket ;
anteriormente, era un resource.
|