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 版本的用户可用。否则将会抛出一个警告!
所返回的关联数组的各字段具体含义如下:
- "country_code" -- 由两个字母组成的国家代码(参见 geoip_country_code_by_name())
- "region" -- 地区代码。 (比如: CA 对应 California)
参数
-
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 )