array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.socket-create-listen.php', 1 => 'socket_create_listen', 2 => 'Abre um soquete em uma porta para aceitar conexões', ), 'up' => array ( 0 => 'ref.sockets.php', 1 => 'Funções de Socket', ), 'prev' => array ( 0 => 'function.socket-create.php', 1 => 'socket_create', ), 'next' => array ( 0 => 'function.socket-create-pair.php', 1 => 'socket_create_pair', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/sockets/functions/socket-create-listen.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

socket_create_listen

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

socket_create_listen — Abre um soquete em uma porta para aceitar conexões

Descrição

socket_create_listen(int $port, int $backlog = SOMAXCONN): Socket|false

socket_create_listen() cria uma nova instância de Socket do tipo AF_INET escutando em todas as interfaces locais na porta informada aguardando por novas conexões.

O objetivo desta função é facilitar a tarefa de criação de um novo soquete que apenas escuta para aceitar novas conexões.

Parâmetros

port

A porta na qual deve-se escutar em todas as interfaces.

backlog

O parâmetro backlog define o comprimento máximo até o qual a fila de conexões pendentes pode crescer. SOMAXCONN pode ser passado como parâmetro backlog, consulte socket_listen() para mais informação.

Valor Retornado

socket_create_listen() retorna uma nova instância de Socket em caso de sucesso ou false em caso de erro. O código de erro pode ser recuperado com socket_last_error(). Este código pode ser passado a socket_strerror() para obter uma explicação textual do erro.

Registro de Alterações

Versão Descrição
8.4.0 O valor padrão de backlog agora é SOMAXCONN. Anteriormente era 128.
8.0.0 Em caso de sucesso, esta função agora retorna uma instância de Socket; anteriormente, retornava um resource.

Notas

Nota:

Se a intenção for criar um soquete que somente escuta em uma certa interface, é necessário usar socket_create(), socket_bind() e socket_listen().

Veja Também