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

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

    <title>Cadenas de Validadores</title>

    <para>Frecuentemente deben aplicarse múltiples validaciones a algún valor
        en un orden particular. El siguiente código demuestra una forma de
        resolver el ejemplo de la <link linkend="zend.validate.introduction"
            >introducción</link>, donde el nombre de usuario debe tener entre 6
        y 12 caracteres alfanuméricos.
    </para>   
       
        <programlisting language="php"><![CDATA[
// Crea una cadena de validadores y le agrega validadores
$validatorChain = new Zend_Validate();
$validatorChain->addValidator(
                    new Zend_Validate_StringLength(array('min' => 6,
                                                         'max' => 12)))
               ->addValidator(new Zend_Validate_Alnum());

// Valida el username
if ($validatorChain->isValid($username)) {
    // username pasó la validación
} else {
    // username falló en la validación; muestre las razones
    foreach ($validatorChain->getMessages() as $message) {
        echo "$message\n";
    }
}
]]></programlisting>

<para>
Los validadores se ejecutan en el orden en que se agregaron
        a <methodname>Zend_Validate</methodname>. En el ejemplo anterior, el
        nombre de usuario, primero se comprueba que su longitud esté entre 6 y
        12 caracteres y luego se controla para garantizar que sólo contiene
        caracteres alfanuméricos. La segunda validación; de caracteres
        alfanuméricos; se realiza independientemente de que la primera
        validación; de longitud entre 6 y 12 caracteres; tenga éxito. Esto
        significa que si ambas validaciones fallan,
            <methodname>getMessages()</methodname> devolverá mensajes de fracaso
        desde ambos validadores.</para>

    <para>En algunos casos tiene sentido detener la cadena de validación si
        falla alguno de los procesos de validación.
            <classname>Zend_Validate</classname> acepta tales casos pasando como
        segundo parámetro el método <methodname>addValidator()</methodname>.
        Poniendo <methodname>$breakChainOnFailure</methodname> a
            <constant>TRUE</constant>, el validador agregado quebrará la cadena
        de ejecución por el fracaso, que evita correr cualquier otra validación
        que se decida que es innecesaria o inapropiada para la situación. Si el
        ejemplo anterior fue escrito como sigue, entonces el sistema de
        validación alfanumérica no se ejecutará si falla la longitud del string
        de validación:
        </para>
       
        <programlisting language="php"><![CDATA[
$validatorChain->addValidator(
                    new Zend_Validate_StringLength(array('min' => 6,
                                                         'max' => 12)),
                    true)
               ->addValidator(new Zend_Validate_Alnum());
]]></programlisting>
  

    <para>Cualquier objeto que implemente
            <classname>Zend_Validate_Interface</classname> puede ser utilizado
        en una cadena de validación.</para>

</sect1>