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

<?xml version="1.0" encoding="UTF-8"?>
<!-- Reviewed: no -->
<!-- EN-Revision: 14978 -->
<sect2 id="zend.validate.set.hostname">

    <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[
$validator = new Zend_Validate_Hostname();
if ($validator->isValid($hostname)) {
    // ホスト名は正しい形式のようです
} else {
    // 不正な形式なので、理由を表示します
    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 のインスタンスを作成する際にパラメータを渡します。
        このパラメータには、どの形式のホスト名を許可するのかを表す整数値を指定しなければなりません。
        できるだけ、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[
$validator = new Zend_Validate_Hostname(Zend_Validate_Hostname::ALLOW_IP);
if ($validator->isValid($hostname)) {
    // ホスト名は正しい形式のようです
} else {
    // 不正な形式なので、理由を表示します
    foreach ($validator->getMessages() as $message) {
        echo "$message\n";
    }
}
]]>
        </programlisting>
    </para>

    <para>
        <code>ALLOW_ALL</code> を使用してすべての形式を許可するほかに、
        これらの形式を組み合わせることもできます。
        たとえば、DNS およびローカルホスト名を許可するには、
        Zend_Validate_Hostname のインスタンスを次のように作成します。
        <programlisting role="php"><![CDATA[
$validator = new Zend_Validate_Hostname(Zend_Validate_Hostname::ALLOW_DNS | Zend_Validate_Hostname::ALLOW_IP);]]>
        </programlisting>

    </para>

    <para>
        <emphasis role="strong">国際化ドメイン名の検証</emphasis>
    </para>

    <para>
        国別コードトップレベルドメイン (Country Code Top Level Domains: ccTLDs)
        の一部、たとえば 'de' (ドイツ) などでは、ドメイン名の中に国際化文字の使用をサポートしています。
        これは、国際化ドメイン名 (International Domain Names: IDN) といわれるものです。
        これらのドメインについても、Zend_Validate_Hostname
        の検証プロセスで使用する文字を拡張することで検証することができます。
    </para>

    <para>
        現在は、次のような ccTLD をサポートしています。

        <itemizedlist>
                <listitem>
                    <para>at (オーストリア)</para>
                </listitem>
                <listitem>
                    <para>ch (スイス)</para>
                </listitem>
                <listitem>
                    <para>li (リヒテンシュタイン)</para>
                </listitem>
                <listitem>
                    <para>de (ドイツ)</para>
                </listitem>
                <listitem>
                    <para>fi (フィンランド)</para>
                </listitem>
                <listitem>
                    <para>hu (ハンガリー)</para>
                </listitem>
                <listitem>
                    <para>no (ノルウェー)</para>
                </listitem>
                <listitem>
                    <para>se (スウェーデン)</para>
                </listitem>
        </itemizedlist>

    </para>

    <para>
        IDN ドメインに対するマッチングを行う方法は、通常のホスト名の場合とまったく同じです。
        というのも、IDN のマッチングはデフォルトで有効になっているからです。
        IDN の検証を無効にしたい場合は、Zend_Validate_Hostname
        のコンストラクタにパラメータを渡すか、あるいは
        <code>$validator->setValidateIdn()</code> メソッドを使用します。
    </para>

    <para>
        IDN の検証を無効にするには、Zend_Validate_Hostname
        のコンストラクタに二番目のパラメータを次のように渡します。

        <programlisting role="php"><![CDATA[
$validator = new Zend_Validate_Hostname(Zend_Validate_Hostname::ALLOW_DNS, false);]]>
        </programlisting>

        あるいは、TRUE または FALSE を
        <code>$validator->setValidateIdn()</code> に渡すことで、
        IDN の検証を有効あるいは無効にすることもできます。

        現在サポートされていない IDN ホスト名に対するマッチングを行おうとすると、
        国際化文字が含まれている場合に検証に失敗します。
        追加の文字を指定した ccTLD ファイルが Zend/Validate/Hostname
        に存在しない場合は、通常のホスト名の検証を行います。
    </para>

    <para>
        IDN の検証は、DNS ホスト名の検証を有効にしている場合にのみ行われることに注意しましょう。
    </para>

    <para>
        <emphasis role="strong">トップレベルドメインの検証</emphasis>
    </para>

    <para>
        デフォルトでは、ホスト名の検証は既知の TLD の一覧に基づいて行われます。
        この機能が不要な場合は、IDN サポートを無効にするのと同じ方法で無効にすることができます。
        TLD の検証を無効にするには、Zend_Validate_Hostname のコンストラクタに三番目のパラメータを渡します。
        以下の例では、IDN の検証は二番目のパラメータで有効にしています。

        <programlisting role="php"><![CDATA[
$validator = new Zend_Validate_Hostname(Zend_Validate_Hostname::ALLOW_DNS, true, false);]]>
        </programlisting>

        あるいは、TRUE または FALSE を
        <code>$validator->ValidateTld()</code> に渡すことで、
        TLD の検証を有効あるいは無効にすることもできます。
    </para>

    <para>
        TLD の検証は、DNS ホスト名の検証を有効にしている場合にのみ行われることに注意しましょう。
    </para>

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