Atenção |
Esta função é EXPERIMENTAL. Isso quer dizer que o comportamento desta função e seu nome, incluindo TUDO o que está documentado aqui pode mudar em futuras versões do PHP, SEM QUALQUER NOTIFICAÇÃO. Esteja avisado, e use esta função 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
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 falhas. 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().