geoip_region_by_name

(PECL geoip >= 0.2.0)

geoip_region_by_name — 獲取國家和地區(qū)代碼

說明

geoip_region_by_name(string $hostname): array

geoip_region_by_name() 函數將會返回與主機或者 IP 地址相關的國家和地區(qū)代碼。

該函數只對購買了商業(yè) GeoIP Region 版本的用戶可用。否則將會拋出一個警告！

所返回的關聯數組的各字段具體含義如下：

  • "country_code" -- 由兩個字母組成的國家代碼(參見 geoip_country_code_by_name())
  • "region" -- 地區(qū)代碼。 (比如: CA 對應 California)

參數

hostname

查找的主機或者 IP 地址。

返回值

成功，返回關聯數組， 如果信息未找到則返回 false。

范例

示例 #1 geoip_region_by_name() 例子：

以下例程將會打印對應 example.com 主機的包含國家和地區(qū)代碼的關聯數組。

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

以上例程會輸出：

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