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

<?xml version="1.0" encoding="UTF-8"?>
<!-- Reviewed: no -->
<!-- EN-Revision: 24249 -->
<sect1 id="zend.validate.validator_chains">

    <title>バリデータチェイン</title>

    <para>
        ひとつの値に対して、複数のバリデータを指定した順に適用しなければならないことがよくあります。
        以下のコードは、<link
            linkend="zend.validate.introduction">導入</link>
        で説明した例を解決するための方法を示すものです。
        ユーザ名が 6 文字から 12 文字までの英数字であるかどうかを検証します。
    </para>

    <programlisting language="php"><![CDATA[
// バリデータチェインを作成し、そこにバリデータを追加します
$validatorChain = new Zend_Validate();
$validatorChain->addValidator(
                    new Zend_Validate_StringLength(array('min' => 6,
                                                         'max' => 12)))
               ->addValidator(new Zend_Validate_Alnum());

// ユーザ名を検証します
if ($validatorChain->isValid($username)) {
    // ユーザ名は検証を通過しました
} else {
    // ユーザ名の検証に失敗しました。理由を表示します
    foreach ($validatorChain->getMessages() as $message) {
        echo "$message\n";
    }
}
]]></programlisting>

    <para>
        バリデータは、<classname>Zend_Validate</classname> に追加した順に適用されます。
        上の例では、まずユーザ名の長さが 6 文字から 12 文字までの間であるかどうかを調べます。
        その後で、英数字のみであるかどうかだけを調べます。
        二番目の検証である「英数字かどうか」は、最初の検証である
        「6 文字から 12 文字まで」が成功したかどうかにかかわらず行われます。
        つまり、もし両方の検証に失敗した場合は、<methodname>getMessages()</methodname>
        は両方の検証失敗メッセージを返すことになります。
    </para>

    <para>
        検証が失敗した時点で、その後の検証を行わずにチェインを抜け出したいこともあるでしょう。
        <classname>Zend_Validate</classname> はそのような使用法もサポートしています。
        そのためには、<methodname>addValidator()</methodname>
        メソッドの二番目のパラメータを使用します。
        <varname>$breakChainOnFailure</varname> を <constant>TRUE</constant>
        に設定すると、そのバリデータが失敗した時点でチェインを抜け出します。
        これにより、後に続く不要な検証や不適切な検証を行わずにすみます。
        上の例を次のように書き直すと、長さの検証に失敗した場合は
        英数字の検証を行わなくなります。
    </para>

    <programlisting language="php"><![CDATA[
$validatorChain->addValidator(
                    new Zend_Validate_StringLength(array('min' => 6,
                                                         'max' => 12)),
                    true)
               ->addValidator(new Zend_Validate_Alnum());
]]></programlisting>

    <para>
        <classname>Zend_Validate_Interface</classname> を実装したオブジェクトなら何でも、
        バリデータチェインで使用できます。
    </para>

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