array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'zh', ), 'this' => array ( 0 => 'function.geoip-region-by-name.php', 1 => 'geoip_region_by_name', 2 => '获取国家和地区代码', ), 'up' => array ( 0 => 'ref.geoip.php', 1 => 'GeoIP 函数', ), 'prev' => array ( 0 => 'function.geoip-record-by-name.php', 1 => 'geoip_record_by_name', ), 'next' => array ( 0 => 'function.geoip-region-name-by-code.php', 1 => 'geoip_region_name_by_code', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'zh', 'path' => 'reference/geoip/functions/geoip-region-by-name.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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。

示例

示例 #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
)