geoip_region_by_name
(PECL geoip >= 0.2.0)
geoip_region_by_name — 獲取國家和地區程式碼
說明
geoip_region_by_name(string
$hostname
): arraygeoip_region_by_name() 函式將會返回與主機或者 IP 地址相關的國家和地區程式碼。
該函式只對購買了商業 GeoIP Region 版本的使用者可用。否則將會拋出一個警告!
所返回的關聯陣列的各欄位具體含義如下:
- "country_code" -- 由兩個字母組成的國家程式碼(參見 geoip_country_code_by_name())
- "region" -- 地區程式碼。 (比如: CA 對應 California)
參數
-
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 )