Inicia uma conexão em um soquete

# socket_connect

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

socket_connect — Inicia uma conexão em um soquete

### Descrição

function 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

- socket_bind() - Vincula um nome a um soquete
- socket_listen() - Escuta uma conexão em um soquete
- socket_create() - Cria um soquete (ponto de extremidade para comunição)
- socket_last_error() - Retorna o último erro no soquete
- socket_strerror() - Retorna uma string descrevendo um erro no soquete

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open