(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)
socket_listen — Escuta uma conexão em um soquete
Após o soquete socket ter sido criado
usando socket_create() e vinculado a um nome com
socket_bind(), ele pode ser instruído a escutar conexões
de entrada no socket.
socket_listen() é aplicável somente a soquetes do
tipo SOCK_STREAM ou
SOCK_SEQPACKET.
socketUma instância de Socket criada com socket_create() ou socket_addrinfo_bind().
backlog
O parâmetro backlog (passivo) define um máximo de conexões de entrada
que serão enfileiradas para processamento. Se uma solicitação de conexão chegar com a fila
cheia, o cliente poderá receber um erro com uma indicação de
ECONNREFUSED ou, se o protocolo subjacente suportar
retransmissão, a solicitação poderá ser ignorada para que novas tentativas possam ser bem-sucedidas.
Nota:
O número máximo passado para o parâmetro
backlogdepende muito da plataforma subjacente. No Linux, ele é truncado silenciosamente paraSOMAXCONN. No win32, se for passadoSOMAXCONN, o provedor de serviços subjacente responsável pelo soquete definirá o passivo para um valor máximo razoável. Não há nenhuma provisão padrão para descobrir o valor real do passivo nesta plataforma.
Retorna true em caso de sucesso ou false em caso de falha. O código de erro pode ser recuperado com
socket_last_error(). Este código pode ser passado para
socket_strerror() para obter uma explicação textual do
erro.
| Versão | Descrição |
|---|---|
| 8.0.0 |
O parâmetro socket agora espera uma instância de Socket;
anteriormente, um resource era esperado.
|