mirror of
https://github.com/fofolee/uTools-Manuals.git
synced 2025-06-19 14:22:43 +08:00
108 lines
4.0 KiB
HTML
108 lines
4.0 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
|
<html>
|
|
<head>
|
|
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
|
|
<title>获取国家和地区代码</title>
|
|
</head>
|
|
<body class="docs"><div id="layout">
|
|
<div id="layout-content"><div id="function.geoip-region-by-name" class="refentry">
|
|
<div class="refnamediv">
|
|
<h1 class="refname">geoip_region_by_name</h1>
|
|
<p class="verinfo">(PECL geoip >= 0.2.0)</p><p class="refpurpose"><span class="refname">geoip_region_by_name</span> — <span class="dc-title">获取国家和地区代码</span></p>
|
|
|
|
</div>
|
|
<div class="refsect1 description" id="refsect1-function.geoip-region-by-name-description">
|
|
<h3 class="title">说明</h3>
|
|
<div class="methodsynopsis dc-description">
|
|
<span class="methodname"><strong>geoip_region_by_name</strong></span>
|
|
( <span class="methodparam"><span class="type">string</span> <code class="parameter">$hostname</code></span>
|
|
) : <span class="type">array</span></div>
|
|
|
|
|
|
<p class="para rdfs-comment">
|
|
<span class="function"><strong>geoip_region_by_name()</strong></span> 函数将会返回与主机或者 IP 地址相关的国家和地区代码。
|
|
</p>
|
|
<p class="para">
|
|
该函数只对购买了商业 GeoIP Region 版本的用户可用。否则将会抛出一个警告！
|
|
</p>
|
|
<p class="para">
|
|
所返回的关联数组的各字段具体含义如下：
|
|
</p>
|
|
<p class="para">
|
|
<ul class="itemizedlist">
|
|
<li class="listitem">
|
|
<span class="simpara">
|
|
"country_code" -- 由两个字母组成的国家代码(参见
|
|
<span class="function"><a href="geoip_country_code_by_name.html" class="function">geoip_country_code_by_name()</a></span>)
|
|
</span>
|
|
</li>
|
|
<li class="listitem">
|
|
<span class="simpara">
|
|
"region" -- 地区代码。 (比如: CA 对应 California)
|
|
</span>
|
|
</li>
|
|
</ul>
|
|
</p>
|
|
</div>
|
|
|
|
<div class="refsect1 parameters" id="refsect1-function.geoip-region-by-name-parameters">
|
|
<h3 class="title">参数</h3>
|
|
<p class="para">
|
|
<dl>
|
|
|
|
|
|
<dt>
|
|
<code class="parameter">hostname</code></dt>
|
|
|
|
<dd>
|
|
|
|
<p class="para">
|
|
查找的主机或者 IP 地址。
|
|
</p>
|
|
</dd>
|
|
|
|
|
|
</dl>
|
|
|
|
</p>
|
|
</div>
|
|
|
|
<div class="refsect1 returnvalues" id="refsect1-function.geoip-region-by-name-returnvalues">
|
|
<h3 class="title">返回值</h3>
|
|
<p class="para">
|
|
成功，返回关联数组， 如果信息未找到则返回 <strong><code>FALSE</code></strong>。
|
|
</p>
|
|
</div>
|
|
|
|
|
|
<div class="refsect1 examples" id="refsect1-function.geoip-region-by-name-examples">
|
|
<h3 class="title">范例</h3>
|
|
<p class="para">
|
|
<div class="example" id="example-4498">
|
|
<p><strong>Example #1 <span class="function"><strong>geoip_region_by_name()</strong></span> 例子：</strong></p>
|
|
<div class="example-contents"><p>
|
|
以下例程将会打印对应 example.com 主机的包含国家和地区代码的关联数组。
|
|
</p></div>
|
|
<div class="example-contents">
|
|
<div class="phpcode"><pre><span style="color: #000000">
|
|
<span style="color: #0000BB"><?php<br />$region </span><span style="color: #007700">= </span><span style="color: #0000BB">geoip_region_by_name</span><span style="color: #007700">(</span><span style="color: #DD0000">'www.example.com'</span><span style="color: #007700">);<br />if (</span><span style="color: #0000BB">$region</span><span style="color: #007700">) {<br /> </span><span style="color: #0000BB">print_r</span><span style="color: #007700">(</span><span style="color: #0000BB">$region</span><span style="color: #007700">);<br />}<br /></span><span style="color: #0000BB">?></span>
|
|
</span>
|
|
</pre></div>
|
|
</div>
|
|
|
|
<div class="example-contents"><p>以上例程会输出：</p></div>
|
|
<div class="example-contents screen">
|
|
<div class="cdata"><pre>
|
|
Array
|
|
(
|
|
[country_code] => US
|
|
[region] => CA
|
|
)
|
|
</pre></div>
|
|
</div>
|
|
</div>
|
|
</p>
|
|
</div>
|
|
|
|
|
|
</div></div></div></body></html> |