geoip_region_by_name
(PECL geoip >= 0.2.0)
geoip_region_by_name — 国コードおよび地域を取得する
説明
geoip_region_by_name
( string $hostname
) : array
geoip_region_by_name() 関数は、 ホスト名あるいは IP アドレスに対応する国および地域を返します。
現在この関数を使用できるのは、商用の GeoIP Region Edition を購入した人だけです。 適切なデータベースが見つからない場合には警告が発生します。
返される連想配列には、以下のようなさまざまな名前のキーが含まれます。
- "country_code" -- 二文字の国コード (geoip_country_code_by_name() を参照ください)
- "region" -- 地域コード (例: カリフォルニアなら CA)
パラメータ
hostname
- 地域を探す対象となるホスト名あるいは IP アドレス。
返り値
成功した場合には連想配列、
アドレスがデータベースで見つからない場合には false
を返します。
例
例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 )