Symfony/Validator pour PHP : guide complet avec exemples

1. Qu'est-ce que c'est et pourquoi l'utiliser ?

La bibliothèque Symfony/Validator est un composant puissant et flexible de l'écosystème Symfony, conçu pour la validation de données. Contrairement aux vérifications "à la volée", ce composant propose une approche déclarative : vous décrivez les règles de validation (contraintes) à l'aide d'annotations, d'attributs PHP 8+, YAML, XML ou de tableaux PHP, puis vous transmettez les données à un service spécialisé : ValidatorInterface. Cela permet de séparer la logique de validation de la logique métier de l'application, rendant le code plus propre, plus testable et plus réutilisable.

Pourquoi en avez-vous besoin ? Dans toute application web (et au-delà), les données proviennent de sources non fiables : formulaires sur le site, requêtes API, import de fichiers CSV. Sans validation, vous risquez des injections SQL, des attaques XSS, des calculs erronés ou simplement des "déchets" dans votre base de données. Symfony/Validator résout ces problèmes de manière globale : il vérifie les types de données, les longueurs de chaînes, les plages numériques, l'unicité des emails, la conformité aux expressions régulières et bien plus encore. De plus, il collecte toutes les erreurs dans un objet unique ConstraintViolationList, facilement convertible en réponse JSON pour une API ou affichable sous forme de liste d'erreurs sur un formulaire.

Le composant est totalement indépendant du framework Symfony. Vous pouvez l'utiliser dans n'importe quel projet PHP (Laravel, Yii, votre propre framework ou même du PHP "pur"). Il est activement maintenu, dispose d'une excellente documentation et d'une immense communauté. C'est le "standard de référence" pour la validation dans le monde PHP.

2. Installation

L'installation se fait via Composer. Exécutez dans le terminal à la racine de votre projet :

composer require symfony/validator

Il est également recommandé d'installer le composant symfony/property-access pour un fonctionnement correct avec les objets imbriqués et les tableaux :

composer require symfony/property-access

Si vous prévoyez d'utiliser des annotations/attributs, assurez-vous d'avoir installé doctrine/annotations (pour PHP 7.x) ou d'utiliser PHP 8+ avec les attributs natifs.

3. Démarrage rapide — exemple minimal fonctionnel

Créons une classe simple User avec des attributs de validation et testons-la.

<?php
// 1. Inclure l'autoloader de Composer
require_once 'vendor/autoload.php';

// 2. Importer les classes nécessaires
use Symfony\Component\Validator\Validation;
use Symfony\Component\Validator\Constraints as Assert;

// 3. Créer une classe avec des attributs de validation (PHP 8+)
class User {
    #[Assert\NotBlank(message: "Le nom ne peut pas être vide")]
    #[Assert\Length(min: 2, max: 50, minMessage: "Le nom doit contenir au moins {{ limit }} caractères")]
    public string $name;

    #[Assert\NotBlank]
    #[Assert\Email(message: "L'email '{{ value }}' n'est pas valide.")]
    public string $email;

    #[Assert\PositiveOrZero]
    public int $age;
}

// 4. Créer le validateur
$validator = Validation::createValidatorBuilder()
    ->enableAttributeMapping() // Activer la prise en charge des attributs
    ->getValidator();

// 5. Créer un objet avec des données incorrectes
$user = new User();
$user->name = 'A'; // Nom trop court
$user->email = 'pas-un-email';
$user->age = -5;

// 6. Valider
$violations = $validator->validate($user);

// 7. Traiter les erreurs
if (count($violations) > 0) {
    foreach ($violations as $violation) {
        echo $violation->getPropertyPath() . ': ' . $violation->getMessage() . "\n";
    }
} else {
    echo "Données valides !";
}

Cet exemple affichera :

name: Le nom doit contenir au moins 2 caractères
email: L'email 'pas-un-email' n'est pas valide.
age: Cette valeur doit être positive ou nulle.

4. Méthodes / fonctions / classes principales

4.1. Validation::createValidatorBuilder()

Signature :