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

# 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

### 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
    )

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