array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.socket-addrinfo-lookup.php', 1 => 'socket_addrinfo_lookup', 2 => 'Obtém array com conteúdo de getaddrinfo() sobre o servidor informado', ), 'up' => array ( 0 => 'ref.sockets.php', 1 => 'Funções de Socket', ), 'prev' => array ( 0 => 'function.socket-addrinfo-explain.php', 1 => 'socket_addrinfo_explain', ), 'next' => array ( 0 => 'function.socket-atmark.php', 1 => 'socket_atmark', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/sockets/functions/socket-addrinfo-lookup.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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

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