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

function 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:

  • "continent_code" -- Código do continente de duas letras (a partir da versão 1.0.4 com libgeoip 1.4.3 ou mais recente)

  • "country_code" -- Código do país com duas letras (consulte geoip_country_code_by_name())

  • "country_code3" -- Código do país de três letras (consulte geoip_country_code3_by_name())

  • "country_name" -- O nome do país (consulte geoip_country_name_by_name())

  • "region" -- O código de região (ex: QC para Quebec)

  • "city" -- A cidade.

  • "postal_code" -- O Código Postal, FSA ou CEP.

  • "latitude" -- A latitude como um float com sinal.

  • "longitude" -- A longitude como um float com sinal.

  • "dma_code" -- Código de área de mercado designado (somente EUA e Canadá)

  • "area_code" -- O código de área PSTN (ex: 212)

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

Examples

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
)

Melhore Esta Página

Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema
＋adicionar nota

Notas de Usuários

Não há notas de usuários para esta página.