Présentation
Les validateurs dans Copix (3.0.3+) sont un moyen de définir des contrôles à appliquer sur des valeurs / objets / tableaux. Par exemple, un validateur de type "email" permet de valider qu'une chaine de caractère représente bien un email valide.
Il existe des validateurs fournis en standard avec Copix, et vous pouvez créer vos propres validateurs (en implémentant ICopixValidator).
Exemple basique d'utilisation
<?php $validator = new CopixValidatorEmail (); if ($validator->check ('monadressemail@copix.org') !== true){ //Cette adresse email n'est pas valide. On a reçu un objet de type CopixErrorObject } ?>
On peut également passer par la fabrique de validateur
<?php if (CopixValidatorFactory::create ('email')->check ('monadressemail@copix.org') !== true){ //Cette adresse email n'est pas valide. On a reçu un objet de type CopixErrorObject } ?>
Et il existe bien sûr un racourcis? pour la fabrique :
<?php if (_validator ('email')->check ('monadressemail@copix.org') !== true){ //Cette adresse email n'est pas valide. On a reçu un objet de type CopixErrorObject } ?>
Notes additionnelles
Il existe trois types de "validateur", a savoir :
- Les validateurs simples (qui implémentent ICopixValidator) qui héritent généralement de CopixAbstractValidator)
- Les validateurs composites (qui implémentent ICopixCompositeValidator?)
- Les validateurs complexes (qui implémentent ICopixComplexTypeValidator?)
Liste des validateurs livrés en standard
Bien sûr, cette liste est amené à évoluer dans les futures versions de Copix
