La vérification de la conformité des champs est faite :
- en PHP coté serveur.
- en javascript avec jQuery Validation Plugin.
Si javascript est désactivé ou si dans les options l'attribut jquery_validate n'est pas à 1, la validation se fera en PHP coté serveur.
Attribut « rules »
[field_name]
...
rules.rule1.value=rule1_value
rules.rule1.message=rule1_message
rules.rule2.value=rule2_value
rules.rule2.message=rule2_message
...
;Exemple :
;rules.required.value=1
;rules.required.message="Ce champ est requis."
;rules.minlength.value=3
;rules.minlength.message="Rentrer au moins 3 caractères."
required
[field_name]
...
rules.required.value=1
;Message optionnel
rules.required.message=Lorem ipsum dolor sit amet
Message défaut :
- text, textarea : Ce champ est obligatoire.
- select : Veuillez sélectionner une option.
- checkbox : Veuillez cocher cette case.
- radio : Veuillez cocher un bouton.
- multi_check : Veuillez cocher au moins une case.
- multi_select : Veuillez sélectionner au moins une option.
- file : Veuillez sélectionner un fichier
minlength
[field_name]
...
rules.minlength.value=3
;Message optionnel
rules.minlength.message=Lorem ipsum dolor sit amet
Message défaut :
- text, textarea : Veuillez fournir au moins %s caractère(s)
- multi_check : Veuillez cocher au moins %s case(s).
- multi_select : Veuillez sélectionner au moins %s option(s).
maxlength
[field_name]
...
rules.maxlength.value=20
;Message optionnel
rules.maxlength.message=Lorem ipsum dolor sit amet
Message défaut :
- text, textarea : Veuillez fournir au plus %s caractère(s)
- multi_check : Veuillez cocher %s case(s) maximum.
- multi_select : Veuillez sélectionner %s option(s) maximum.
rangelength
[field_name]
...
rules.rangelength.value=5,10
;Message optionnel
rules.rangelength.message=Lorem ipsum dolor sit amet
Les 2 valeurs séparées par une virgule.
Message défaut :
- text, textarea : Veuillez fournir une valeur qui contient entre %s et %s caractères.
- multi_check : Veuillez cocher entre %s et %s case(s).
- multi_select : Veuillez sélectionner entre %s et %s option(s).
min
[field_name]
...
rules.min.value=10
;Message optionnel
rules.min.message=Lorem ipsum dolor sit amet
Message défaut :
- text : Veuillez fournir une valeur supérieure ou égale à %s.
max
[field_name]
...
rules.max.value=20
;Message optionnel
rules.max.message=Lorem ipsum dolor sit amet
Message défaut :
- text : Veuillez fournir une valeur inférieure ou égale à %s.
range
[field_name]
...
rules.range.value=20,40
;Message optionnel
rules.range.message=Lorem ipsum dolor sit amet
Les 2 valeurs séparées par une virgule.
Message défaut :
- text : Veuillez fournir une valeur entre %s et %s.
pattern
[field_name]
...
rules.pattern.value="^([a-zA-Z0-9]{3,8})$"
;Message optionnel
rules.pattern.message=Lorem ipsum dolor sit amet
Message défaut :
- text : Format invalide.
equal
[field_name]
...
rules.equal.value=toto
;Message optionnel
rules.equal.message=Lorem ipsum dolor sit amet
Message défaut :
- text : Veuillez fournir une valeur égale à %s.
equalTo
[field_name]
...
rules.equalTo.value=field_name_1
;Message optionnel
rules.equalTo.message=Lorem ipsum dolor sit amet
field_name_1 : id d'un autre champ du formulaire.
Message défaut :
- text : Veuillez fournir encore la même valeur.
in_list
[field_name]
...
rules.in_list.value='toto','titi'
;Message optionnel
rules.in_list.message=Lorem ipsum dolor sit amet
Liste de valeurs séparées par une virgule.
Message défaut :
- text : La valeur doit être dans la liste.
not_in_list
[field_name]
...
rules.not_in_list.value='toto','titi'
;Message optionnel
rules.not_in_list.message=Lorem ipsum dolor sit amet
Liste de valeurs séparées par une virgule.
Message défaut :
- text : La valeur ne doit pas être dans la liste.
[field_name]
...
rules.email.value=1
;Message optionnel
rules.email.message=Lorem ipsum dolor sit amet
Message défaut :
- text : Veuillez fournir une adresse électronique valide.
url
[field_name]
...
rules.url.value=1
;Message optionnel
rules.url.message=Lorem ipsum dolor sit amet
Message défaut :
- text : Veuillez fournir une adresse URL valide.
number
[field_name]
...
rules.number.value=1
;Message optionnel
rules.number.message=Lorem ipsum dolor sit amet
Message défaut :
- text : Veuillez fournir un numéro valide.
digits
[field_name]
...
rules.digits.value=1
;Message optionnel
rules.digits.message=Lorem ipsum dolor sit amet
Message défaut :
- text : Veuillez fournir seulement des chiffres.
integer
[field_name]
...
rules.integer.value=1
;Message optionnel
rules.integer.message=Lorem ipsum dolor sit amet
Message défaut :
- text : Veuillez fournir un nombre non décimal positif ou négatif.
lettersonly
[field_name]
...
rules.lettersonly.value=1
;Message optionnel
rules.lettersonly.message=Lorem ipsum dolor sit amet
Message défaut :
- text : Veuillez fournir seulement des lettres.
alphanumeric
[field_name]
...
rules.alphanumeric.value=1
;Message optionnel
rules.alphanumeric.message=Lorem ipsum dolor sit amet
Message défaut :
- text : Veuillez fournir seulement des lettres, chiffres ou underscore.
nowhitespace
[field_name]
...
rules.nowhitespace.value=1
;Message optionnel
rules.nowhitespace.message=Lorem ipsum dolor sit amet
Message défaut :
- text : Veuillez ne pas inscrire d'espaces blancs.
max_file_size
[field_name]
...
rules.max_file_size.value=10000
;Message optionnel
rules.max_file_size.message=Lorem ipsum dolor sit amet
Taille en octets.
Message défaut :
- file : Le fichier excède la taille maximum autorisée.
accept
[field_name]
...
rules.accept.value=png,jpg
;Message optionnel
rules.accept.message=Lorem ipsum dolor sit amet
Liste d'extensions acceptées séparées par une virgule.
Message défaut :
- file : Extension de fichier invalide.
fileexists
[field_name]
...
rules.fileexists.value='../dossier/dossier1'
;Message optionnel
rules.fileexists.message=Lorem ipsum dolor sit amet
Contrôle l'existence d'un fichier sur le serveur.
Exemple : Si on veut contrôler l'existence du fichier toto.txt dans le chemin ../dossier/dossier1 on vérifiera donc ../dossier/dossier1/toto.txt (le nom du fichier est ajouté au chemin par le script).
On part toujours de la racine du serveur.
Message défaut :
- text : Le nom de fichier (ou dossier) existe déjà.
user_rule
[field_name]
...
rules.user_rule.value=my_function
;Message optionnel
rules.user_rule.message=Lorem ipsum dolor sit amet
Fonction PHP définie par l'utilisateur. Les valeurs de retour doivent être :
- true : si le champ est valide
- false : si le champ est invalide
Exemple : le champ doit-être égal à toto
function my_function($r) {
return ($r == 'toto') ? true : false;
}
Cela ne fonctionne (pour l'instant !) qu'en validation coté serveur.
Message défaut :
- text, textarea : Champ invalide.