geoip_region_by_name
(PECL geoip:0.2.0-1.0.1)
geoip_region_by_name — 国コードおよび地域を取得する
説明
array geoip_region_by_name
( string $hostname
)
geoip_region_by_name() 関数は、 ホスト名あるいは IP アドレスに対応する国および地域を返します。
現在この関数を使用できるのは、商用の GeoIP Region Edition を購入した人だけです。 適切なデータベースが見つからない場合には警告が発生します。
返される連想配列には、以下のようなさまざまな名前のキーが含まれます。
- "country_code" -- 二文字の国コード (geoip_country_code_by_name() を参照ください)
- "region" -- 地域コード (例: カリフォルニアなら CA)
パラメータ
- hostname
-
地域を探す対象となるホスト名あるいは IP アドレス。
返り値
成功した場合には連想配列、 アドレスがデータベースで見つからない場合には FALSE を返します。
例
Example#1 geoip_region_by_name() の例
これは、ホスト example.com の国コードおよび地域を含む配列を表示します。
<?php
$region = geoip_region_by_name('www.example.com');
if ($region) {
print_r($region);
}
?>
上の例の出力は以下となります。
Array ( [country_code] => US [region] => CA )