documentation/manual/zh/module_specs/Zend_Validate-ValidatorChains.xml

   1 <sect1 id="zend.validate.validator_chains">
   2
   3     <title>校验器链</title>
   4
   5     <para>
   6         通常，多个校验器按照特定的顺序被用于某些值。下面的代码示范一个办法去解决<link linkend="zend.validate.introduction">introduction</link>中的例子的要求，即用户名必须在6到12个字符的文字数字组合：
   7         <programlisting role="php"><![CDATA[
   8 // Create a validator chain and add validators to it
   9 $validatorChain = new Zend_Validate();
  10 $validatorChain->addValidator(new Zend_Validate_StringLength(6, 12))
  11                ->addValidator(new Zend_Validate_Alnum());
  12
  13 // Validate the username
  14 if ($validatorChain->isValid($username)) {
  15     // username passed validation
  16 } else {
  17     // username failed validation; print reasons
  18     foreach ($validatorChain->getMessages() as $message) {
  19         echo "$message\n";
  20     }
  21 ]]>
  22         </programlisting>
  23
  24         校验器按照它们被加到<code>Zend_Validate</code>的顺序执行。在上面的例子中，用户名首先被检查来确保它的长度在6到12个字符，然后它被检查来确保它只包含文字和数字。不管第一个校验（检查长度是否6到12）是否成功，第二个校验（检查是否文字数字组合）总被执行。这就意味着如果两个校验都失败，<code>getMessages()</code>将为两个校验器都返回失败信息。
  25     </para>
  26
  27     <para>
  28         在某些情况下，如果校验过程失败， 让校验器中断校验器链符合常识。<code>Zend_Validate</code> 在<code>addValidator()</code>方法中使用第二个参数来支持这样的用例。通过设置<code>$breakChainOnFailure</code>为<code>true</code>，如果校验失败，校验器将中断校验器链执行，这样就避免了在这个情形下运行其他已经被决定是不必要的或不适当的校验。如果上面的例子被写成如下，如果字串长度校验失败，文字数字组合校验就不会发生：
  29         <programlisting role="php"><![CDATA[
  30 $validatorChain->addValidator(new Zend_Validate_StringLength(6, 12), true)
  31                ->addValidator(new Zend_Validate_Alnum());
  32 ]]>
  33         </programlisting>
  34
  35     </para>
  36
  37     <para>
  38         任何实现<code>Zend_Validate_Interface</code>的对象都可以被用作校验器链。
  39     </para>
  40
  41 </sect1>
  42 <!--
  43 vim:se ts=4 sw=4 et:
  44 -->