repo_zf1/documentation/manual/zh/module_specs/Zend_Validate-Hostname.xml

<sect2 id="zend.validate.set.hostnames">

    <title>主机名</title>

    <para>
        Zend_Validate_Hostname允许你根据一组已知的规范来校验主机名。它检查三种不同的主机名：DNS主机名（例如domain.com），IP地址（例如1.2.3.4），和本地主机名（例如localhost）。缺省地，只有DNS主机名被匹配。
    </para>

    <para>
        <emphasis role="strong">基本用法</emphasis>
    </para>

    <para>
        一个基本用法的例子如下：

        <programlisting role="php"><![CDATA[<?php
require_once 'Zend/Validate/Hostname.php';
$validator = new Zend_Validate_Hostname();
if ($validator->isValid($hostname)) {
    // hostname appears to be valid
} else {
    // hostname is invalid; print the reasons
    foreach ($validator->getMessages() as $message) {
        echo "$message\n";
    }
}

]]>
        </programlisting>

        这个例子匹配主机名<code>$hostname</code>并在匹配失败的时候用<code>$validator->getMessages()</code>来获得有用的错误信息。

    </para>

    <para>
        <emphasis role="strong">校验不同类型的主机名</emphasis>
    </para>

    <para>
        你可能发现你也想匹配IP地址，本地主机名，或者是所有允许类型的组合。这个可以在当你实例化它的时候通过传递参数给Zend_Validate_Hostname来实现。 参数应该是一个整型数，它来决定哪种主机名被允许。我们鼓励你使用常量。
    </para>

    <para>
        Zend_Validate_Hostname 常量是： <code>ALLOW_DNS</code> 允许DNS主机名，
        <code>ALLOW_IP</code> 允许IP地址， <code>ALLOW_LOCAL</code> 允许本地网络名，和<code>ALLOW_ALL</code> 允许所有三种类型。 你可以用下面的例子仅仅检查IP地址：

        <programlisting role="php"><![CDATA[<?php
require_once 'Zend/Validate/Hostname.php';
$validator = new Zend_Validate_Hostname(Zend_Validate_Hostname::ALLOW_IP);
if ($validator->isValid($hostname)) {
    // hostname appears to be valid
} else {
    // hostname is invalid; print the reasons
    foreach ($validator->getMessages() as $message) {
        echo "$message\n";
    }
}

]]>
        </programlisting>
    </para>

    <para>
        你可以用这些类型的组合，也可以用<code>ALLOW_ALL</code>来接受所有主机名类型。例如，你可以通过如下例子实例化Zend_Validate_Hostname对象来接受DNS和本地主机名:
        <programlisting role="php"><![CDATA[<?php

$validator = new Zend_Validate_Hostname(Zend_Validate_Hostname::ALLOW_DNS | Zend_Validate_Hostname::ALLOW_LOCAL);}]]>
        </programlisting>

    </para>

    <para>
        <emphasis role="strong">校验国际域名</emphasis>
    </para>

    <para>
        一些国家代码顶级域名（ccTLDs），例如'de'（德国），在域名中支持国际字符。这些就是大家所知的国际域名（IDN）。这些域名可以用Zend_Validate_Hostname通过用于校验处理的扩展字符来匹配。
    </para>

    <para>
        目前支持ccTLDs的有：

        <itemizedlist>
                <listitem>
                    <para>at (Austria)</para>
                </listitem>
                <listitem>
                    <para>ch (Switzerland)</para>
                </listitem>
                <listitem>
                    <para>li (Liechtenstein)</para>
                </listitem>
                <listitem>
                    <para>de (Germany)</para>
                </listitem>
                <listitem>
                    <para>fi (Finland)</para>
                </listitem>
                <listitem>
                    <para>hu (Hungary)</para>
                </listitem>
                <listitem>
                    <para>no (Norway)</para>
                </listitem>
                <listitem>
                    <para>se (Sweden)</para>
                </listitem>
        </itemizedlist>

    </para>

    <para>
        匹配IDN域名就像使用标准主机名校验器一样简单，因为IDN匹配是缺省激活的。如果你想禁止IDN校验，可以通过传递参数给Zend_validate_Hostname构造器或通过<code>$validator->setValidateIdn()</code>方法来实现。
    </para>

    <para>
        你可以象下面通过传递第二个参数给Zend_Validate_Hostname构造器来禁止IDN校验。
        <programlisting role="php"><![CDATA[<?php

$validator = new Zend_Validate_Hostname(Zend_Validate_Hostname::ALLOW_DNS, false);]]>
        </programlisting>

        另外你可以通过传递 TRUE 或 FALSE 给 <code>$validator->setValidateIdn()</code> 来激活或者禁止 IDN 校验。如果你试图匹配一个当前不被支持的IDN主机名，并且如果有国际字符在其中，校验很可能会失败。当指定附加字符的ccTLD文件在Zend/Validate/Hostname下不存在时，一个正常的主机名校验将被执行。（这就是在解释上句话中为什么校验会失败，Jason 注）
    </para>

    <para>
        请注意只有当你允许DNS主机名被校验，IDNs才能被校验。
    </para>

    <para>
        <emphasis role="strong">校验顶级域名</emphasis>
    </para>

    <para>
        缺省地主机名通过已知的TLDs列表来检查。如果不需要这个功能，它可以被禁止，就像禁止IDN支持一样。你可以通过传递第三个参数给Zend_Validate_Hostname构造器来禁止TLD校验。在下面的例子中，我们通过第二个参数来支持IDN校验。

        <programlisting role="php"><![CDATA[<?php

$validator = new Zend_Validate_Hostname(Zend_Validate_Hostname::ALLOW_DNS, true, false);]]>
        </programlisting>

        另外，你可以通过传递 TRUE 或 FALSE 给
        <code>$validator->setValidateTld()</code> 来激活或禁止 TLD 校验。
    </para>

    <para>
        请注意只有当你允许DNS主机名被校验，TLDs才能被校验。
    </para>

</sect2>
<!--
vim:se ts=4 sw=4 et:
-->