socket_listen
(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)
socket_listen — Abre escuta para uma conexão no socket
Descrição
socket_listen(resource $socket
, int $backlog
= ?): bool
AvisoEsta função é
EXPERIMENTAL. O comportamento desta função, seu nome e
documentação poderão mudar sem aviso prévio em futuras versões do PHP.
Use por sua conta e risco.
Após o socket socket
ter sido criado usando
socket_create() e associado para um nome com
socket_bind(), ele deve dizer para aguardar por escuta em conexões
que irão entrar socket
.
Um máximo de backlog
em conexões entrantes irão ser listadas
para este processamento. Se uma requisição de conexão chegar com um limite de clientes
devem receber um erro com uma identificação de
ECONNREFUSED
, ou, se o protocolo abaixo suporta retransmissão,
a requisição deve ser ignorada de forma até serem bem sucedidas.
Nota:
O máximo número passado para o parâmetro backlog
altamente dependente da plataforma abaixo. No linux, isso é
silenciosamente truncado para SOMAXCONN
. No win32, se
passado SOMAXCONN
, o disponibilizador de serviço abaixo
responsável pelo socket irá configurar o backlog para o valor máximo
reasonable. Não há uma condição para procurar
o valor do backlog atual nesta plataforma.
socket_listen() é aplicável somente para sockets do tipo SOCK_STREAM
ou
SOCK_SEQPACKET
.
Retorna true
em caso de sucesso ou false
em caso de falha. O código de erro pode ser retornado com
socket_last_error(). Isso código deve ser passado para
socket_strerror() para pegar uma explicação textual do
erro.
Veja também
socket_accept(),
socket_bind(),
socket_connect(),
socket_create() e
socket_strerror().