array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.socket-listen.php', 1 => 'socket_listen', 2 => 'Escuta uma conexão em um soquete', ), 'up' => array ( 0 => 'ref.sockets.php', 1 => 'Funções de Socket', ), 'prev' => array ( 0 => 'function.socket-last-error.php', 1 => 'socket_last_error', ), 'next' => array ( 0 => 'function.socket-read.php', 1 => 'socket_read', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/sockets/functions/socket-listen.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

socket_listen

(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)

socket_listen — Escuta uma conexão em um soquete

Descrição

socket_listen(Socket $socket, int $backlog = 0): bool

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.

Parâmetros

socket

Uma 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 backlog depende muito da plataforma subjacente. No Linux, ele é truncado silenciosamente para SOMAXCONN. No win32, se for passado SOMAXCONN, 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.

Valor Retornado

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.

Registro de Alterações

Versão Descrição
8.0.0 O parâmetro socket agora espera uma instância de Socket; anteriormente, um resource era esperado.

Veja Também