Symfony : rendre un champ obligatoire selon une case cochée

Symfony : rendre un champ obligatoire selon une case cochée

19 nov. 2026 · 6 min de lecture · 5 vues
// crédit : Illustration ChatGPT
TL;DR Un nom de société obligatoire uniquement pour les achats professionnels : un exemple concret avec When, un formulaire Symfony, le rendu Twig et les vérifications à effectuer.

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.

PUBLICITÉ
Comparaison de la validation : achat personnel et nom vide acceptés ; achat professionnel et nom vide refusés.
La même saisie vide est acceptée ou refusée selon la case Achat professionnel. Schéma explicatif, pas une capture d’écran. — La Revue Geek — schéma original

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.

SUR LA CHAÎNE · NOUVELLE VIDÉO Parrallels Desktop 27 : 1 code, 3 OS : comment je développe RustMusic sur Mac Voir la vidéo →

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.

PUBLICITÉ

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 professionnelNom saisiRésultat attendu
DécochéVideValide
CochéVideRefusé, message sous le nom de société
CochéTrois espacesRefusé, même message
CochéAtelier GeekValide

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 groupe Default.
  • Une exception évoque ExpressionLanguage : contrôlez l’installation de symfony/expression-language dans l’environnement qui exécute PHP.
  • Le formulaire est invalide, mais le message manque : utilisez form_row() ou ajoutez explicitement form_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

Cette astuce t'a aidé ? ça a marché ?
écrit par LaRevueGeek décrypte l'actualité high-tech et la culture geek depuis 2014 : tests, bons plans, ciné et tout ce qui touche, de près ou de loin, au monde des geeks.
S'abonner · 33,2 k
$ ls ./a-lire-aussi

À lire aussi

Toutes les astuces →

Commentaires

0
~/commentaires — nouveau
$ connecte-toi pour donner ton avis…
connecté en invité · se connecter Créer un compte
0% lu
💬 0