geoip_region_by_name

(PECL geoip >= 0.2.0)

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

說明

geoip_region_by_name(string $hostname): array

geoip_region_by_name() 函數(shù)將會(huì)返回與主機(jī)或者 IP 地址相關(guān)的國(guó)家和地區(qū)代碼。

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

所返回的關(guān)聯(lián)數(shù)組的各字段具體含義如下：

  • "country_code" -- 由兩個(gè)字母組成的國(guó)家代碼(參見 geoip_country_code_by_name())
  • "region" -- 地區(qū)代碼。 (比如: CA 對(duì)應(yīng) California)

參數(shù)

hostname

查找的主機(jī)或者 IP 地址。

返回值

成功，返回關(guān)聯(lián)數(shù)組， 如果信息未找到則返回 false。

范例

示例 #1 geoip_region_by_name() 例子：

以下例程將會(huì)打印對(duì)應(yīng) example.com 主機(jī)的包含國(guó)家和地區(qū)代碼的關(guān)聯(lián)數(shù)組。

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

以上例程會(huì)輸出：

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