array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.geoip-record-by-name.php', 1 => 'geoip_record_by_name', 2 => 'Retorna as informações detalhadas da cidade encontradas no banco de dados GeoIP', ), 'up' => array ( 0 => 'ref.geoip.php', 1 => 'Funções de GeoIP', ), 'prev' => array ( 0 => 'function.geoip-org-by-name.php', 1 => 'geoip_org_by_name', ), 'next' => array ( 0 => 'function.geoip-region-by-name.php', 1 => 'geoip_region_by_name', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/geoip/functions/geoip-record-by-name.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

geoip_record_by_name

(PECL geoip >= 0.2.0)

geoip_record_by_name — Retorna as informações detalhadas da cidade encontradas no banco de dados GeoIP

Descrição

geoip_record_by_name(string $hostname): array

A função geoip_record_by_name() retornará as informações de registro correspondentes a um nome de host ou endereço IP.

Esta função está disponível tanto para o GeoLite City Edition quanto para o GeoIP City Edition. Um aviso será emitido se o banco de dados apropriado não puder ser localizado.

Os nomes das diferentes chaves do array associativo de retorno são os seguintes:

Parâmetros

hostname
O nome do host ou endereço IP cujo registro deve ser consultado.

Valor Retornado

Retorna o array associativo em caso de sucesso, ou false se o endereço não puder ser encontrado no banco de dados.

Registro de Alterações

Versão Descrição
PECL geoip 1.0.4 Adicionando o continent_code apenas com a biblioteca GeoIP 1.4.3 ou mais recente
PECL geoip 1.0.3 Adicionando country_code3 e country_name

Exemplos

Exemplo #1 Um exemplo de geoip_record_by_name()

Isso exibirá o array contendo o registro do host example.com.

<?php
$record = geoip_record_by_name('www.example.com');
if ($record) {
print_r($record);
}
?>

O exemplo acima produzirá:

Array
(
    [continent_code] => NA
    [country_code] => US
    [country_code3] => USA
    [country_name] => United States
    [region] => CA
    [city] => Marina Del Rey
    [postal_code] =>
    [latitude] => 33.9776992798
    [longitude] => -118.435096741
    [dma_code] => 803
    [area_code] => 310
)