Récapitulatif - Validateur de formulaires

Fait partie de la section Programmation Orientée Objet du Journey PHP de Coddy. Leçon 69 sur 91.

Défi

Facile

Construisons un validateur de formulaire d’inscription utilisateur qui collecte les erreurs de validation et les signale toutes en une seule fois, plutôt que de s’arrêter au premier problème. C’est ainsi que fonctionne la validation des formulaires dans le monde réel : les utilisateurs veulent voir tous les problèmes liés à leur envoi, et non les corriger un par un.

Vous organiserez votre code sur quatre fichiers :

ValidationException.php : créez une classe de base ValidationException qui étend Exception. Elle sert de classe parente pour toutes les exceptions liées à la validation.
Exceptions.php : incluez le fichier ValidationException et créez trois classes d’exception spécifiques qui étendent ValidationException :
- RequiredFieldException : accepte un nom de champ dans son constructeur et transmet le message "[fieldName] is required" à la classe parente
- InvalidEmailException : accepte une chaîne contenant une adresse e-mail dans son constructeur et transmet le message "'[email]' is not a valid email" à la classe parente
- MinLengthException : accepte un nom de champ et une longueur minimale (int) dans son constructeur et transmet le message "[fieldName] must be at least [minLength] characters" à la classe parente
FormValidator.php : incluez le fichier Exceptions et créez une classe FormValidator avec ces méthodes de validation :
- validateRequired(?string $value, string $fieldName): string : lève RequiredFieldException si la valeur est nulle ou vide (après suppression des espaces superflus), sinon renvoie la valeur sans espaces superflus
- validateEmail(string $email): string : lève InvalidEmailException si l’adresse e-mail est invalide (utilisez filter_var avec FILTER_VALIDATE_EMAIL), sinon renvoie l’adresse e-mail
- validateMinLength(string $value, string $fieldName, int $minLength): string : lève MinLengthException si la longueur de la chaîne est inférieure à la longueur minimale, sinon renvoie la valeur
main.php : incluez le fichier FormValidator. Vous recevrez trois entrées : un nom d’utilisateur, une adresse e-mail et un mot de passe.
Créez un FormValidator et un tableau vide pour collecter les messages d’erreur. Validez chaque champ dans un bloc try-catch distinct :
- Validez le nom d’utilisateur comme champ obligatoire
- Validez d’abord l’adresse e-mail comme champ obligatoire, puis validez son format
- Validez d’abord le mot de passe comme champ obligatoire, puis vérifiez qu’il comporte une longueur minimale de 8 caractères
Lorsqu’une ValidationException est interceptée, ajoutez son message à votre tableau d’erreurs au lieu d’arrêter l’exécution.

Après toutes les validations, s’il y a des erreurs, affichez chaque message d’erreur sur sa propre ligne. S’il n’y a aucune erreur, affichez "Registration successful".

Ce modèle, qui consiste à collecter toutes les erreurs avant de les signaler, est essentiel pour offrir une bonne expérience utilisateur. Votre hiérarchie d’exceptions permet d’intercepter facilement tous les problèmes de validation avec un seul bloc catch, tout en conservant des types d’exception spécifiques pour les différents échecs de validation.

Essayez vous-même

<?php
require_once 'FormValidator.php';

// Lire les entrées
$username = trim(fgets(STDIN));
$email = trim(fgets(STDIN));
$password = trim(fgets(STDIN));

// Créer une instance de FormValidator
$validator = new FormValidator();

// Créer un tableau vide pour collecter les messages d'erreur
$errors = [];

// TODO: Valider le nom d'utilisateur comme requis dans un bloc try-catch
// Attraper ValidationException et ajouter son message au tableau $errors

// TODO: Valider l'email comme requis d'abord, puis le valider comme un format d'email valide
// Utiliser un bloc try-catch et ajouter tous les messages d'erreur au tableau $errors

// TODO: Valider le mot de passe comme requis d'abord, puis valider la longueur minimale de 8 caractères
// Utiliser un bloc try-catch et ajouter tous les messages d'erreur au tableau $errors

// TODO: Après toutes les validations :
// - S'il y a des erreurs, afficher chaque message d'erreur sur sa propre ligne
// - If there are no errors, print "Registration successful"

?>