Obtém array com conteúdo de getaddrinfo() sobre o servidor informado

# socket_addrinfo_lookup

(PHP 7 >= 7.2.0, PHP 8)

socket_addrinfo_lookup — Obtém array com conteúdo de getaddrinfo() sobre o servidor informado

### Descrição

function socket_addrinfo_lookup(string `$host`, ?string `$service` = `null`, array `$hints` = []): array|false

Pesquisa diferentes formas de se conectar ao servidor informado no parâmetro `host`. O array retornado contém um conjunto de instâncias de AddressInfo que podem ser vinculadas usando socket_addrinfo_bind().

### Parâmetros

`host`

  Nome do servidor a ser pesquisado.

`service`

  O serviço ao qual será feita a conexão. Se o serviço for uma string numérica, ele designa a porta. Caso contrário, ele define o nome do serviço de rede que é mapeado a uma porta pelo sistema operacional.

`hints`

  Este parâmetro contém dicas que fornecem critérios para seleção dos endereços retornados. Pode-se especificar essas dicas conforme definido na chamada getaddrinfo() do sistema operacional.

### Valor Retornado

Retorna um array de instâncias de AddressInfo que podem ser usadas com a família de funções socket_addrinfo_*. Em caso de falha, retorna `false`.

### Registro de Alterações

Versão | Descrição
--- | ---
8.5.0 | Agora lança um TypeError se qualquer valor do array `hints` não puder ser convertido para inteiro, e pode lançar um ValueError se quaisquer desses valores transbordarem.
8.0.0 | Em caso de sucesso, esta função agora retorna um array de instâncias de AddressInfo; anteriormente, retornava um array de resources.
8.0.0 | `service` agora pode ser nulo.

### Veja Também

- socket_addrinfo_bind() - Cria e vincula a um soquete a partir de uma informação de endereço
- socket_addrinfo_connect() - Cria e conecta a um soquete a partir de uma informação de endereço
- socket_addrinfo_explain() - Obtem explicação sobre informação de endereço

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