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

socket_accept

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

socket_accept — Aceita uma conexão em um soquete

Descrição

socket_accept(Socket $socket): Socket|false

Após o soquete socket ter sido criado usando socket_create(), vinculado a um nome com socket_bind(), e instruído a escutar conexões com socket_listen(), essa função aceitará conexões recebidas neste soquete. Uma vez que uma conexão bem sucedida for realizada, uma nova instância de Socket é retornada, que pode ser usada para comunicação. Se houver múltiplas conexões enfileiradas no soquete, a primeira será usada. Se não houver conexões pendentes, socket_accept() bloqueará até que uma conexão esteja presente. Se socket tiver sido criado como não bloqueante usando socket_set_blocking() ou socket_set_nonblock(), false será retornado.

A instância Socket retornada por socket_accept() não pode ser usada para aceitar novas conexões. O soquete de escuta original socket, entretanto, permanecerá aberto e poderá ser reutilizado.

Parâmetros

socket

Uma instância Socket criada com socket_create().

Valor Retornado

Retorna uma nova instância Socket em caso de sucesso, ou false em caso de erro. O código de erro real pode ser obtido chamando-se socket_last_error(). Este código de erro pode ser passado a socket_strerror() para obter uma explicação textual do erro.

Registro de Alterações

Versão Descrição
8.0.0 Em caso de sucesso, esta função agora retorna uma instância de Socket; anteriormente um resource era retornado.

Veja Também