Dutch PHP Conference 2025 - Call For Papers

socket_set_nonblock

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

socket_set_nonblockDefine o modo sem bloqueio para o descritor de arquivo fd

Descrição

socket_set_nonblock(Socket $socket): bool

A função socket_set_nonblock() define o sinalizador O_NONBLOCK no soquete especificado pelo parâmetro socket.

Quando uma operação (ex.: receber, enviar, conectar, aceitar, ...) é executada em um soquete não bloqueante, o script não pausará sua execução até receber um sinal ou poder executar a operação. Em vez disso, se a operação resultar em um bloqueio, a função chamada falhará.

Parâmetros

socket

Uma instância de Socket criada com socket_create() ou socket_accept().

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha.

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.

Exemplos

Exemplo #1 Exemplo de socket_set_nonblock()

<?php
$socket
= socket_create_listen(1223);
socket_set_nonblock($socket);

socket_accept($socket);
?>

Este exemplo cria um soquete de escuta em todas as interfaces na porta 1223 e define o soquete para o modo O_NONBLOCK. socket_accept() falhará imediatamente, a menos que haja uma conexão pendente exatamente neste momento.

Veja Também

add a note

User Contributed Notes 1 note

up
5
kpobococ at gmail dot com
15 years ago
Beware, when using this function within a loop (i.e. a demon with a socket). The socket_accept(), for example, emits a warning each time there is no incoming connection available to be read. My php error log file got huge in a matter of seconds, eventually crashing the server.

Of course, i used the @ before the function to take care of that problem.

[EDITOR: One can (and should) use socket_select to detect a new connection on a socket (it's a "readable" event)]
To Top