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