(PHP 4 >= 4.1.0, PHP 5, PHP 7)
socket_listen — Escucha una conexión sobre un socket
$socket
[, int $backlog
= 0
] ) : bool
Después de que el socket socket
haya sido creado
usando socket_create() y vinculado a un nombre con
socket_bind(), se le puede indicar que escuche conexiones
entrantes sobre socket
.
socket_listen() sólo es aplicable a sockets de
tipo SOCK_STREAM
o
SOCK_SEQPACKET
.
socket
Un recurso socket válido creado con socket_create().
backlog
Se pondrán en cola un máximo de conexiones entrantes backlog
para su procesamiento. Si una petición de conexión llega con la cola
llena, el cliente puede recibir un error con una indicación de
ECONNREFUSED, o, si el protocolo subyacente soporta
retransmisiones, la petición puede ser ignorada, por lo que este reintento puede surtir efecto.
Nota:
El número máximo pasado al parámtro
backlog
depende mayormente en la plataforma subyacente. En Linux, se trunca de forma silenciosa aSOMAXCONN
. En win32, Si se pasóSOMAXCONN
, el proveedor del servicio responsable del socket establecerá el backlog a un valor máximo razonable. No existe una disposicón estándar para encontrar el valor del backlog real en esta plataforma.
Devuelve TRUE
en caso de éxito o FALSE
en caso de error. El código de error real se puede recuperar
llamando a socket_last_error(). Este código se puede
pasar a socket_strerror() para obtener una explicación textual del
error.