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

Descrição

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.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