33.2. Chaînes de validation

Souvent, de multiples validations doivent être appliquées à une valeur dans un ordre particulier. Le code suivant décrit une méthode permettant de solutionner l'exemple de l'introduction, dans lequel un identifiant doit contenir précisemment entre 6 et 12 caractères alphanumériques.

<?php
// On fournit la capacité de chaîner les validateurs
require_once 'Zend/Validate.php';

// Validateurs nécessaires à l'exemple
require_once 'Zend/Validate/StringLength.php';
require_once 'Zend/Validate/Alnum.php';

// Creation d'une chaine de validateurs et ajout de validateurs
$validateurChaine = new Zend_Validate();
$validateurChaine->addValidator(new Zend_Validate_StringLength(6, 12))
                 ->addValidator(new Zend_Validate_Alnum());

// Validation de l'identifiant
if ($validateurChaine->isValid($identifiant)) {
    // l'identifiant est testé avec succès
} else {
    // l'identifiant échoue aux tests, afficher pourquoi
    foreach ($validateurChaine->getMessages() as $message) {
        echo "$message\n";
    }
}
?>

Les validateurs sont exécutés dans leur ordre d'ajout à Zend_Validate. Dans l'exemple ci-dessus, l'identifiant est d'abord testé pour vérifier que sa longueur est bien comprise entre 6 et 12 caractères, puis ensuite testé pour vérifier qu'il ne contient bien que des caractères alphanumériques. Le second test est exécuté quelque soit le résultat du précédent. Ainsi, dans le cas où les deux tests échouent, getMessages() retournera un message d'échec pour chacun des validateurs.

Dans certains cas, il peut être utile d'interrompre le processus si l'un des tests échoue. Zend_Validate permet ce cas de figure via l'usage du deuxième paramètre de la méthode addValidator(). En positionnant $breakChainOnFailure sur true, le validateur ajouté interrompra la procédure de test si il échoue, ce qui permet d'éviter de lancer tout autre test qui serait inutile ou inapproprié dans ce cas de figure. Si l'exemple précédent était écrit comme suit, la validation alphanumérique ne serait pas lancé si la vérification de la longueur de la valeur échouait :

<?php
$validateurChaine->addValidator(new Zend_Validate_StringLength(6, 12), true)
                 ->addValidator(new Zend_Validate_Alnum());
?>

Tout objet qui implémente Zend_Validate_Interface peut être utilisé comme chaîne de validation.