(PHP 4 >= 4.1.0, PHP 5)
socket_listen — Abre escuta para uma conexão no socket
$socket
[, int $backlog
] )Esta função é EXPERIMENTAL. O comportamento desta função, seu nome, incluindo toda documentação pode ser modificado sem aviso em futuras versões do PHP. Esta função deve ser usada por sua própria 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
backlogaltamente dependente da plataforma abaixo. No linux, isso é silenciosamente truncado paraSOMAXCONN. No win32, se passadoSOMAXCONN, 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().