(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)
socket_create_listen — Abre um soquete em uma porta para aceitar conexões
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.
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.
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.
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. |
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().