Votre formulaire de facturation accepte les particuliers et les professionnels. Le nom de société doit rester facultatif pour les premiers, mais devenir obligatoire pour les seconds. Ajouter NotBlank sans condition bloque tout le monde ; mettre simplement required sur le champ ne résout pas la règle métier.
Je pars d’un exemple Symfony 7.4 : une case « Achat professionnel », un champ « Nom de société » et la contrainte When. La vérification se fait sur le serveur, même sans JavaScript, et le message apparaît sous le champ concerné.
Le comportement à obtenir
Case décochée, le formulaire accepte un nom vide. Case cochée, il refuse de continuer tant que le nom de société n’est pas renseigné. Le champ reste affiché dans les deux cas : ce tutoriel porte sur sa validation, pas sur son masquage dynamique.

Prérequis : une application Symfony 7.4 avec PHP 8.2 ou supérieur, Twig et les formulaires configurés. Depuis la racine du projet, installez les composants manquants :
composer require symfony/form symfony/validator symfony/expression-language
ExpressionLanguage permet d’évaluer la condition écrite sous forme de chaîne dans When. Aucun changement de schéma de base de données n’est nécessaire ici : les données du formulaire seront portées par une simple classe PHP.
Documentation officielle : la contrainte When et ses expressions.
Porter la condition dans la classe de données
Créez src/Model/BillingData.php. Si votre application possède déjà un objet adapté, vous pouvez y appliquer le même principe en ajustant les noms.
<?php
namespace App\Model;
use Symfony\Component\Validator\Constraints as Assert;
final class BillingData
{
public bool $professional = false;
#[Assert\When(
expression: 'this.professional == true',
constraints: [
new Assert\NotBlank(
message: 'Indiquez le nom de votre société.'
),
],
)]
public ?string $companyName = null;
}
Dans l’expression, this désigne l’objet BillingData en cours de validation. Lorsque professional vaut true, Symfony applique NotBlank à companyName. Sinon, cette contrainte n’est pas déclenchée.
Le placement de l’attribut compte : il est attaché à companyName, donc la violation concerne cette propriété. Avec le formulaire ci-dessous, Symfony peut afficher le message au bon endroit, sans ajouter une erreur générale en haut de page.
Configurer les champs sans bloquer les particuliers
Créez src/Form/BillingType.php :
<?php
namespace App\Form;
use App\Model\BillingData;
use Symfony\Component\Form\AbstractType;
use Symfony\Component\Form\Extension\Core\Type\CheckboxType;
use Symfony\Component\Form\Extension\Core\Type\TextType;
use Symfony\Component\Form\FormBuilderInterface;
use Symfony\Component\OptionsResolver\OptionsResolver;
final class BillingType extends AbstractType
{
public function buildForm(FormBuilderInterface $builder, array $options): void
{
$builder
->add('professional', CheckboxType::class, [
'label' => 'Achat professionnel',
'required' => false,
])
->add('companyName', TextType::class, [
'label' => 'Nom de société',
'required' => false,
'help' => 'Obligatoire pour un achat professionnel.',
'error_bubbling' => false,
]);
}
public function configureOptions(OptionsResolver $resolver): void
{
$resolver->setDefaults(['data_class' => BillingData::class]);
}
}
required => false évite d’imposer le remplissage dans le navigateur à tous les visiteurs. Cette option n’annule pas NotBlank : le serveur continue de vérifier le nom lorsque la case est cochée. Sur la case elle-même, elle permet aussi de ne pas obliger le visiteur à la cocher.
error_bubbling => false garde l’erreur sur le champ. C’est déjà le comportement habituel de ce champ simple ; je le rends explicite pour montrer le résultat attendu. L’aide précise la condition au lecteur, sans astérisque obligatoire permanent.
Documentation officielle : ce que fait réellement l’option required.
Afficher le formulaire et déclencher la validation
La contrainte ne suffit pas si le traitement ignore les erreurs. Créez src/Controller/BillingController.php pour cette démonstration :
<?php
namespace App\Controller;
use App\Form\BillingType;
use App\Model\BillingData;
use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\Routing\Attribute\Route;
final class BillingController extends AbstractController
{
#[Route('/facturation-demo', name: 'app_billing_demo', methods: ['GET', 'POST'])]
public function index(Request $request): Response
{
$data = new BillingData();
$form = $this->createForm(BillingType::class, $data);
$form->handleRequest($request);
$accepted = $form->isSubmitted() && $form->isValid();
return $this->render('billing/index.html.twig', [
'form' => $form->createView(),
'accepted' => $accepted,
]);
}
}
handleRequest() récupère les valeurs soumises. isSubmitted() distingue l’envoi de la première visite ; isValid() lance la vérification du formulaire et de ses données.
Dans templates/billing/index.html.twig, affichez chaque ligne avec form_row(), qui rend aussi ses erreurs :
{% extends 'base.html.twig' %}
{% block body %}
<h1>Facturation de démonstration</h1>
{% if accepted %}
<p role="status">Formulaire valide. Aucune donnée enregistrée.</p>
{% endif %}
{{ form_start(form) }}
{{ form_errors(form) }}
{{ form_row(form.professional) }}
{{ form_row(form.companyName) }}
<button type="submit">Vérifier</button>
{{ form_end(form) }}
{% endblock %}
Ouvrez /facturation-demo sur votre serveur de développement. La démonstration confirme seulement la validité : elle ne sauvegarde rien et ne facture personne. Dans votre vrai traitement, placez l’enregistrement ou l’action métier uniquement après le contrôle « soumis et valide », puis utilisez une redirection après succès. Conservez la protection CSRF de votre application.
Documentation officielle : traiter un formulaire Symfony.
Vérifier que la condition fait bien son travail
Soumettez successivement ces quatre combinaisons. Le résultat suppose que le reste du formulaire, notamment son jeton CSRF, est valide.
| Achat professionnel | Nom saisi | Résultat attendu |
|---|---|---|
| Décoché | Vide | Valide |
| Coché | Vide | Refusé, message sous le nom de société |
| Coché | Trois espaces | Refusé, même message |
| Coché | Atelier Geek | Valide |
Le cas des espaces mérite un essai : TextType les supprime en début et fin de saisie avec son option trim, activée par défaut. La chaîne devient donc vide avant la validation. Ce comportement vient du formulaire ; ne supposez pas qu’un objet rempli ailleurs, par exemple depuis une API, subira automatiquement le même nettoyage.
Pour cet article, ces quatre soumissions ont également été vérifiées dans un test isolé avec les composants Form et Validator en version 7.4. Le test contrôle la validité et le rattachement de l’erreur à companyName. Il ne remplace pas un test de votre page complète, de votre thème Twig ou de votre traitement métier.
Si le résultat ne correspond pas
- Le navigateur exige toujours le nom : inspectez le HTML rendu et vérifiez qu’un thème Twig ou un attribut ajouté manuellement ne force pas
required. - La case cochée accepte un nom vide : vérifiez
data_class, le nom de propriété dans l’expression et l’appel àisValid(). Vérifiez aussi que des groupes personnalisés n’excluent pas la contrainte du groupeDefault. - Une exception évoque ExpressionLanguage : contrôlez l’installation de
symfony/expression-languagedans l’environnement qui exécute PHP. - Le formulaire est invalide, mais le message manque : utilisez
form_row()ou ajoutez explicitementform_errors(form.companyName)dans votre rendu personnalisé.
Une règle simple à garder côté serveur
Le nom de société est maintenant obligatoire dans la seule situation qui le justifie. La règle reste dans l’objet de données, le formulaire gère la saisie et Twig affiche l’erreur. Vous pouvez ajouter plus tard un affichage dynamique pour le confort d’utilisation sans déplacer cette vérification dans le navigateur.
Questions fréquentes
Faut-il du JavaScript pour rendre le champ obligatoire ?
Non. When applique la condition lors de la validation sur le serveur. JavaScript peut adapter l’affichage, mais ne doit pas être l’unique contrôle de la règle.
Pourquoi ne pas placer NotBlank directement sur companyName ?
Sans When autour, NotBlank s’appliquerait aussi aux particuliers. La condition restreint son application aux achats professionnels.
Le champ est-il effacé lorsque la case est décochée ?
Non. Cette contrainte contrôle la validité, pas le contenu conservé. Si votre métier impose d’effacer le nom pour un particulier, prévoyez ce traitement séparément.
Ce contrôle prouve-t-il que la société existe ?
Non. Il impose uniquement un nom non vide dans le formulaire. La vérification d’un identifiant légal ou d’un numéro de TVA relève d’autres règles.
Les guides officiels pour aller plus loin
- When : condition, variables disponibles et contraintes imbriquées.
- NotBlank : valeurs considérées comme vides.
- TextType et trim : nettoyage de la saisie.
- Options des formulaires : required, error_bubbling et groupes de validation.
- Créer et traiter un formulaire : cycle complet, rendu Twig et validation.
À lire aussi
ARTICLE · 14 NOV. Erreur CORS : faire fonctionner un POST JSON vers une API Symfony
ARTICLE · 2 SEPT. Symfony Messenger : rejouer proprement un message échoué
ARTICLE · 16 AOÛT Composer : Résoudre un conflit Composer sans supprimer composer.lock

Commentaires
0