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.

Note:

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