Programmer avec SPIP 3.0
Documentation technique sur SPIP 3.0

> > > > Vérifier les valeurs soumises

Vérifier les valeurs soumises

La fonction verifier() permet d’analyser les valeurs postées et de retourner éventuellement des erreurs de saisie. Pour cela, la fonction retourne un tableau associatif « champ » / « message d’erreur » pour les champs incriminés, ainsi éventuellement qu’un message d’erreur plus général pour l’ensemble du formulaire sur la clé « message_erreur ».

La fonction de traitement du formulaire sera appelée uniquement si le tableau retourné est vide. Dans le cas contraire, le formulaire est réaffiché avec les différents messages d’erreurs transmis.

  1. function formulaires_nom_verifier_dist() {
  2. $erreurs = array();
  3. foreach(array('titre','texte') as $champ) {
  4. if (!_request($champ)) {
  5. $erreurs[$champ] = "Cette information est obligatoire !";
  6. }
  7. }
  8. if (count($erreurs)) {
  9. $erreurs['message_erreur'] = "Une erreur est présente dans votre saisie";
  10. }
  11. return $erreurs;
  12. }

Télécharger

Le pipeline formulaire_verifier permet de compléter les erreurs retournées.

Exemple

Le plugin « Amis » dispose d’un formulaire pour inviter des personnes à devenir son ami ! La fonction verifier() vérifie que l’adresse mail de la personne à inviter est correcte :

  1. function formulaires_inviter_ami_verifier_dist(){
  2.  
  3. $erreurs = array();
  4. foreach(array('email') as $obli)
  5. if (!_request($obli))
  6. $erreurs[$obli] = (isset($erreurs[$obli])?$erreurs[$obli]:'') . _T('formulaires:info_obligatoire_rappel');
  7.  
  8. if ($e=_request('email')){
  9. if (!email_valide($e))
  10. $erreurs['email'] = (isset($erreurs['email'])?$erreurs['email']:'') . _T('formulaires:email_invalide');
  11. }
  12.  
  13. return $erreurs;
  14. }

Télécharger