array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.geoip-region-by-name.php', 1 => 'geoip_region_by_name', 2 => 'Obtém o código do país e a região', ), 'up' => array ( 0 => 'ref.geoip.php', 1 => 'Funções de GeoIP', ), 'prev' => array ( 0 => 'function.geoip-record-by-name.php', 1 => 'geoip_record_by_name', ), 'next' => array ( 0 => 'function.geoip-region-name-by-code.php', 1 => 'geoip_region_name_by_code', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/geoip/functions/geoip-region-by-name.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

geoip_region_by_name

(PECL geoip >= 0.2.0)

geoip_region_by_name — Obtém o código do país e a região

Descrição

geoip_region_by_name(string $hostname): array

A função geoip_region_by_name() retornará o país e a região correspondentes a um nome de host ou endereço IP.

Esta função está disponível atualmente apenas para usuários que adquiriram uma versão GeoIP Region 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 cuja região deve ser consultada.

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.

Exemplos

Exemplo #1 Um exemplo de geoip_region_by_name()

Isso exibirá o array contendo o código do país e a região do host example.com.

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

O exemplo acima produzirá:

Array
(
    [country_code] => US
    [region] => CA
)