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

socket_connect

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

socket_connect — Inicia uma conexão em um soquete

Descrição

socket_connect(Socket $socket, string $address, ?int $port = null): bool

Inicia uma conexão ao endereço informado em address usando a instância de Socket fornecida em socket, que precisa ser uma instância Socket criada com socket_create().

Parâmetros

socket

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

address

O parâmetro address pode ser um endereço IPv4 na notação de quatro inteiros separados por pontos (ex.: 127.0.0.1) se socket for AF_INET, um endereço válido IPv6 (ex.: ::1) se o suporte a IPv6 estiver habilitado e socket for AF_INET6 ou o caminho para um soquete de domínio Unix, se a família de soquete for AF_UNIX.

port

O parâmetro port é usado somente na conexão a um soquete AF_INET ou AF_INET6 (nesses casos é mandatório), e designa a porta no servidor remoto à qual uma conexão deve ser realizada.

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 a socket_strerror() para obter uma explicação textual do erro.

Nota:

Se o soquete for não bloqueante, esta função retorna false com um erro Operation now in progress (operação agora em andamento).

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.
8.0.0 port agora pode ser nulo.

Veja Também