Bienvenue dans Le Cookbook

Les données pour ce champ ne doivent contenir que chiffres et lettres.

var $validate = array(
    'login' => array(
        'rule' => 'alphaNumeric',
        'message' => 'Les données pour ce champ ne doivent contenir que lettres et chiffres.'
    )
);

1. var $validate = array(
2. 'login' => array(
3. 'rule' => 'alphaNumeric',
4. 'message' => 'Les données pour ce champ ne doivent contenir que lettres et chiffres.'
5. )
6. );

La longueur des données du champ doit être comprise dans la plage numérique spécifiée. Les valeurs minimum et maximum doivent être toutes les deux fournies. Cette méthode utilise <= et non <.

var $validate = array(
    'mot_passe' => array(
        'rule' => array('between', 5, 15),
        'message' => 'Le mot de passe doit avoir une longueur comprise entre 5 et 15 caractères.'
    )
);

1. var $validate = array(
2. 'mot_passe' => array(
3. 'rule' => array('between', 5, 15),
4. 'message' => 'Le mot de passe doit avoir une longueur comprise entre 5 et 15 caractères.'
5. )
6. );

La longueur des données est "le nombre d'octets dans la représentation des données sous forme de chaîne". Faites attention, car elle peut être plus grande que le nombre de caractères quand vous manipulez des caractères non-ASCII.

Cette règle est utilisé pour vérifier que le champ est laissé vide ou que seulement des caractères blancs y sont présent. Les caractères blancs incluent l'espace, la tabulation, le retour chariot et nouvelle ligne.

var $validate = array(
    'id' => array(
        'rule' => 'blank',
        'on' => 'create'
    )
);

1. var $validate = array(
2. 'id' => array(
3. 'rule' => 'blank',
4. 'on' => 'create'
5. )
6. );

Les données pour ce champ doivent être une valeur booléenne. Les valeurs possibles sont : true ou false, les entiers 0 ou 1, les chaînes '0' ou '1'.

var $validate = array(
    'maCaseACocher' => array(
        'rule' => array('boolean'),
        'message' => 'Valeur incorrecte pour maCaseACocher'
    )
);

1. var $validate = array(
2. 'maCaseACocher' => array(
3. 'rule' => array('boolean'),
4. 'message' => 'Valeur incorrecte pour maCaseACocher'
5. )
6. );

Cette règle est utilisée pour vérifier si une donnée est un numéro de carte de crédit valide. Elle prend trois paramètres : 'type', 'deep' et 'regex'.

Le paramètre 'type' peut être assigné aux valeurs 'fast', 'all' ou à l'une des suivantes :

• amex
• bankcard
• diners
• disc
• electron
• enroute
• jcb
• maestro
• mc
• solo
• switch
• visa
• voyager

Si 'type' est défini à 'fast', cela valide les données de la majorité des formats numériques de cartes de crédits. Définir 'type' à 'all' vérifiera tous les types de cartes de crédits. Vous pouvez aussi définir 'type' comme un tableau des types que vous voulez détecter.

Le paramètre 'deep' devrait être défini comme une valeur booléenne. S'il est défini à true, la validation vérifiera l'algorithme Luhn de la carte de crédit (http://en.wikipedia.org/wiki/Luhn_algorithm). Par défaut, elle est à false.

Le paramètre 'regex' vous permet de passer votre propre expression régulière, laquelle sera utilisée pour valider le numéro de la carte de crédit.

var $validate = array(
    'numero_cc' => array(
        'rule' => array('cc', array('visa', 'maestro'), false, null),
        'message' => 'Le numéro de carte de crédit que vous avez saisi était invalide.'
    )
);

1. var $validate = array(
2. 'numero_cc' => array(
3. 'rule' => array('cc', array('visa', 'maestro'), false, null),
4. 'message' => 'Le numéro de carte de crédit que vous avez saisi était invalide.'
5. )
6. );

Comparison est utilisé pour comparer des valeurs numériques. Il supporte "est supérieur", "est inférieur", "supérieur ou égal", "inférieur ou égal", "égal à" et "non égal". Quelques exemples sont indiqués ci-dessous :

var $validate = array(
    'age' => array(
        'rule' => array('comparison', '>=', 18),
        'message' => 'Vous devez avoir 18 ans au moins pour vous inscrire.'
);

var $validate = array(
    'age' => array(
        'rule' => array('comparison', 'greater or equal', 18),
        'message' => 'Vous devez avoir 18 ans au moins pour vous inscrire.'
    )
);

1. var $validate = array(
2. 'age' => array(
3. 'rule' => array('comparison', '>=', 18),
4. 'message' => 'Vous devez avoir 18 ans au moins pour vous inscrire.'
5. );
6. var $validate = array(
7. 'age' => array(
8. 'rule' => array('comparison', 'greater or equal', 18),
9. 'message' => 'Vous devez avoir 18 ans au moins pour vous inscrire.'
10. )
11. );

Cette règle s'assure que les données soumises sont des formats de date valides. Un seul paramètre (qui peut être un tableau) doit être passé et sera utilisé pour vérifier le format de la date soumise. La valeur de ce paramètre peut être l'une des suivantes :

• 'dmy', par exemple : 27-12-2006 ou 27-12-06 (les séparateurs peuvent être l'espace, le point, le tiret, le slash)
• 'mdy', par exemple : 12-27-2006 ou 12-27-06 (les séparateurs peuvent être l'espace, le point, le tiret, le slash)
• 'ymd', par exemple : 2006-12-27 ou 06-12-27 (les séparateurs peuvent être l'espace, le point, le tiret, le slash)
• 'dMy', par exemple : 27 Décembre 2006 ou 27 Déc 2006
• 'Mdy', par exemple : Décembre 27, 2006 ou Déc 27, 2006 (la virgule est optionnelle)
• 'My', par exemple : (Décembre 2006 ou Déc 2006)
• 'my', par exemple : 12/2006 ou 12/06 (les séparateurs peuvent être l'espace, le point, le tiret, le slash)

Si aucune clé n'est soumise, la clé par défaut 'ymd' sera utilisée.

var $validate = array(
    'naissance' => array(
        'rule' => 'date',
        'message' => 'Entrez une date valide au format AA-MM-JJ.',
        'allowEmpty' => true
    )
);

1. var $validate = array(
2. 'naissance' => array(
3. 'rule' => 'date',
4. 'message' => 'Entrez une date valide au format AA-MM-JJ.',
5. 'allowEmpty' => true
6. )
7. );

Etant donné que de nombreux moteurs de stockage réclament un certain format de date, vous devriez envisager de faire le plus gros du travail en acceptant un large choix de formats et en essayant de les convertir, plutôt que de forcer les gens à les soumettre dans un format donné. Le plus de travail vous ferez pour les utilisateurs, le mieux ce sera.

Cette règle s'assure que la donnée est un nombre décimal valide. Un paramètre peut être passé pour spécifier le nombre de décimales requises après le point. Si aucun paramètre n'est passé, la donnée sera validée comme un nombre scientifique à virgule flottante, entraînant une erreur si aucune décimale n'est trouvée après le point.

var $validate = array(
    'prix' => array(
        'rule' => array('decimal', 2)
    )
);

1. var $validate = array(
2. 'prix' => array(
3. 'rule' => array('decimal', 2)
4. )
5. );

Celle-ci vérifie que la donnée soit une adresse email valide. En passant un booléen true comme second paramètre de cette règle, elle tentera de vérifier aussi, que l'hôte de l'adresse soit valide.

var $validate = array('email' => array('rule' => 'email'));
 
var $validate = array(
    'email' => array(
        'rule' => array('email', true),
        'message' => 'Merci de soumettre une adresse email valide.'
    )
);

1. var $validate = array('email' => array('rule' => 'email'));
3. var $validate = array(
4. 'email' => array(
5. 'rule' => array('email', true),
6. 'message' => 'Merci de soumettre une adresse email valide.'
7. )
8. );

Cette règle s'assurera que la valeur est égal à la valeur passée et qu'elle est du même type.

var $validate = array(
    'nourriture' => array(
        'rule' => array('equalTo', 'gâteau'),  
        'message' => 'Cette valeur devrait être la chaîne gâteau'
    )
);

1. var $validate = array(
2. 'nourriture' => array(
3. 'rule' => array('equalTo', 'gâteau'),
4. 'message' => 'Cette valeur devrait être la chaîne gâteau'
5. )
6. );

Cette règle vérifie les extensions valides de fichier, comme .jpg ou .png. Permet la vérification d'extensions multiples, en les passant sous forme de tableau.

var $validate = array(
    'image' => array(
        'rule' => array('extension', array('gif', 'jpeg', 'png', 'jpg')),
        'message' => 'Merci de soumettre une image valide.'
    )
);

1. var $validate = array(
2. 'image' => array(
3. 'rule' => array('extension', array('gif', 'jpeg', 'png', 'jpg')),
4. 'message' => 'Merci de soumettre une image valide.'
5. )
6. );

Cette règle s'assure que la valeur est un nom de fichier valide. Cette règle de validation n'est pour le moment pas fonctionnelle.

Cette règle s'assurera qu'une adresse IPv4 valide ait été soumise.

var $validate = array(
    'ip_client' => array(
        'rule' => 'ip',
        'message' => 'Merci de soumettre une adresse IP valide.'
    )
);

1. var $validate = array(
2. 'ip_client' => array(
3. 'rule' => 'ip',
4. 'message' => 'Merci de soumettre une adresse IP valide.'
5. )
6. );

La donnée pour le champ doit être unique, elle ne peut être utilisée par aucune autre ligne.

var $validate = array(
    'login' => array(
        'rule' => 'isUnique',
        'message' => 'Ce nom d\'utilisateur a déjà été choisi.'
    )
);

1. var $validate = array(
2. 'login' => array(
3. 'rule' => 'isUnique',
4. 'message' => 'Ce nom d\'utilisateur a déjà été choisi.'
5. )
6. );

Cette règle s'assure que la donnée satisfait à la longueur minimale requise.

var $validate = array(
    'login' => array(
        'rule' => array('minLength', '8'),  
        'message' => 'Les noms d\'utilisateur doivent avoir au moins 8 caractères.'
    )
);

1. var $validate = array(
2. 'login' => array(
3. 'rule' => array('minLength', '8'),
4. 'message' => 'Les noms d\'utilisateur doivent avoir au moins 8 caractères.'
5. )
6. );

La longueur des données est "le nombre d'octets dans la représentation des données sous forme de chaîne". Faites attention, car elle peut être plus grande que le nombre de caractères quand vous manipulez des caractères non-ASCII.

Cette règle s'assure que la donnée respecte la longueur maximale requise.

var $validate = array(
    'login' => array(
        'rule' => array('maxLength', '15'),  
        'message' => 'Les noms d\'utilisateur ne doivent pas dépasser 15 caractères.'
    )
);

1. var $validate = array(
2. 'login' => array(
3. 'rule' => array('maxLength', '15'),
4. 'message' => 'Les noms d\'utilisateur ne doivent pas dépasser 15 caractères.'
5. )
6. );

La longueur ici est "le nombre d'octets dans la représentation des données sous forme de chaîne". Faites attention car elle pourrait être plus grande que le nombre de caractères en manipulant des caractères non-ASCII.

Cette règle s'assurera que la valeur est une somme monétaire valide.

Le second paramètre définit où le symbole est situé (gauche/droite).

var $validate = array(
    'salaire' => array(
        'rule' => array('money', 'left'),
        'message' => 'Merci de soumettre une somme monétaire valide.'
    )
);

1. var $validate = array(
2. 'salaire' => array(
3. 'rule' => array('money', 'left'),
4. 'message' => 'Merci de soumettre une somme monétaire valide.'
5. )
6. );

Utilisez cette règle pour valider un champ select multiple. Elle accepte les paramètres "in", "max" et "min".

var $validate = array(
    'multiple' => array(
        'rule' => array('multiple', array('in' => array('do', 'ré', 'mi', 'fa', 'sol', 'la', 'si'), 'min' => 1, 'max' => 3)),
        'message' => 'Merci de choisir une, deux ou trois options'
    )
);

1. var $validate = array(
2. 'multiple' => array(
3. 'rule' => array('multiple', array('in' => array('do', 'ré', 'mi', 'fa', 'sol', 'la', 'si'), 'min' => 1, 'max' => 3)),
4. 'message' => 'Merci de choisir une, deux ou trois options'
5. )
6. );

Cette règle s'assurera que la valeur est dans un ensemble donné. Elle nécessite un tableau des valeurs. Le champ est valide si sa valeur vérifie l'une des valeurs du tableau donné.

Exemple :

	var $validate = array(
	  'fonction' => array(
	  	'choixAutorise' => array(
	  		'rule' => array('inList', array('Foo', 'Bar')),
	  		'message' => 'Entrez soit Foo, soit Bar.'
	  	)
	  )
	);

1. var $validate = array(
2. 'fonction' => array(
3. 'choixAutorise' => array(
4. 'rule' => array('inList', array('Foo', 'Bar')),
5. 'message' => 'Entrez soit Foo, soit Bar.'
6. )
7. )
8. );

Vérifie si la donnée passée est un nombre valide.

var $validate = array(
    'voitures' => array(
        'rule' => 'numeric',  
        'message' => 'Merci de soumettre le nombre de voitures.'
    )
);

1. var $validate = array(
2. 'voitures' => array(
3. 'rule' => 'numeric',
4. 'message' => 'Merci de soumettre le nombre de voitures.'
5. )
6. );

La règle de base pour s'assurer qu'un champ n'est pas vide.

var $validate = array(
    'titre' => array( 
        'rule' => 'notEmpty',
        'message' => 'Ce champ ne peut pas rester vide'
    )
);

1. var $validate = array(
2. 'titre' => array(
3. 'rule' => 'notEmpty',
4. 'message' => 'Ce champ ne peut pas rester vide'
5. )
6. );

Ne l'utilisez pas pour un champ select multiple, sinon cela causera une erreur. A la place, utilisez "multiple".

Phone valide les numéros de téléphone US. Si vous voulez valider des numéros de téléphones non-US, vous pouvez fournir une expression régulière comme second paramètre pour couvrir des formats de numéros additionnels.

var $validate = array(
    'telephone' => array(
        'rule' => array('phone', null, 'us')
    )
);

1. var $validate = array(
2. 'telephone' => array(
3. 'rule' => array('phone', null, 'us')
4. )
5. );

Postal est utilisé pour valider des codes postaux des U.S.A. (us), du Canada (ca), du Royaume-Uni (uk), de l'Italie (it), d'Allemagne (de) et de Belgique (be). Pour les autres formats de codes postaux, vous devez fournir une expression régulière comme second paramètre.

var $validate = array(
    'code_postal' => array(
        'rule' => array('postal', null, 'us')
    )
);

1. var $validate = array(
2. 'code_postal' => array(
3. 'rule' => array('postal', null, 'us')
4. )
5. );

Cette règle s'assure que la valeur est dans une fourchette donnée. Si aucune fourchette n'est soumise, la règle s'assurera que la valeur est un nombre limite valide pour la plateforme courante.

var $validate = array(
    'nombre' => array(
        'rule' => array('range', -1, 11),
        'message' => 'Merci d\'entrer un nombre entre 0 et 10'
    )
);

1. var $validate = array(
2. 'nombre' => array(
3. 'rule' => array('range', -1, 11),
4. 'message' => 'Merci d\'entrer un nombre entre 0 et 10'
5. )
6. );

L'exemple ci-dessus acceptera toutes les valeurs qui sont plus grandes que 0 (par ex, 0.01) et plus petite que 10 (par ex, 9.99). Note : Les deux extrémités données (-1 et 11) ne sont pas incluses !!!

Ssn valide les numéros de sécurité sociale des U.S.A. (us), du Danemark (dk) et des Pays-Bas (nl). Pour les autres formats de numéros de sécurité sociale, vous devez fournir une expression régulière.

var $validate = array(
    'ssn' => array(
        'rule' => array('ssn', null, 'us')
    )
);

1. var $validate = array(
2. 'ssn' => array(
3. 'rule' => array('ssn', null, 'us')
4. )
5. );

Cette règle vérifie les formats valides d'URL. Elle supporte les protocoles http(s), ftp(s), file, news et gopher.

var $validate = array(
    'siteweb' => array(
        'rule' => 'url'
    )
);

1. var $validate = array(
2. 'siteweb' => array(
3. 'rule' => 'url'
4. )
5. );

Pour s'assurer qu'un protocole est présent dans l'url, le mode strict mode peut être activé comme ceci.

var $validate = array(
    'siteweb' => array(
        'rule' => array('url', true)
    )
);

1. var $validate = array(
2. 'siteweb' => array(
3. 'rule' => array('url', true)
4. )
5. );