Symfony : – Les formulaires « Fonctionnement »

Le composant Form de Symfony est un outil puissant qui permet de construire, valider et gérer des formulaires complexes tout en assurant une interaction fluide entre les couches Modèle, Vue et Contrôleur. Voici un guide détaillé pour comprendre ses mécanismes.

L’Objet Form

L’objet Form est l’élément central qui relie les données du modèle, les requêtes HTTP et les vues des formulaires. Il est responsable de la gestion des champs, de la soumission des données et de leur validation.

a. Soumission

L’objet Form contient une méthode handleRequest() qui traite une requête HTTP pour déterminer si le formulaire a été soumis. Si oui, il attache les données soumises au formulaire et met à jour l’objet du modèle associé, à condition que les données soient valides.

Exemple :

$form->handleRequest($request);
if ($form->isSubmitted()) {
    $form->submit($request);
}

La méthode submit() permet également de soumettre manuellement des données au formulaire.

b. Validation

Une fois les données soumises, la méthode isValid() vérifie leur conformité avec les contraintes définies. Ces règles de validation peuvent être configurées directement dans le formulaire ou associées à l’objet du modèle.

c. Vue

La méthode createView() génère une représentation du formulaire adaptée à son affichage dans une vue Twig. Cela garantit que les formulaires sont rendus correctement dans l’interface utilisateur.

Les Types de Champs

Les types de champs tels que TextType, SubmitType ou DateType définissent la nature des champs du formulaire. Chaque type est référencé à l’aide de son FQCN (Fully Qualified Class Name) avec le mot-clé ::class.

Exemple :

$form = $this->createFormBuilder($client)
    ->add('nom', TextType::class)
    ->add('valider', SubmitType::class)
    ->getForm();

Les Options des Champs

Chaque champ peut être configuré avec des options pour personnaliser son comportement, son affichage ou ses contraintes.

Exemple : Limiter les années dans un champ de type anniversaire

$form = $this->createFormBuilder($client)
    ->add('date_de_naissance', BirthdayType::class, [
        'years' => range(date('Y') - 77, date('Y') - 7)
    ])
    ->getForm();

Certaines options sont spécifiques à un type de champ, comme years pour les champs de type date. D’autres, comme label ou required, sont communes à plusieurs types.

Objets Form et FormBuilder

a. FormBuilder

Le FormBuilder est utilisé pour configurer et construire un objet Form. Il permet d’ajouter des champs et de définir leur configuration.

Exemple :

$form = $this->createFormBuilder($client)
    ->add('nom', TextType::class)
    ->add('date_de_naissance', BirthdayType::class)
    ->add('valider', SubmitType::class)
    ->getForm();

b. Hiérarchie des Champs

L’objet Form est hiérarchique. Chaque champ ajouté devient un sous-formulaire ou un « nœud ». Ces nœuds peuvent eux-mêmes contenir d’autres nœuds.

Accéder à un sous-formulaire :

$enfant = $form->get('date_de_naissance');
$jour = $form->get('date_de_naissance')->get('day');

Association avec l’Objet du Modèle

Lorsqu’un formulaire est associé à un objet du modèle, Symfony mappe automatiquement les données saisies aux propriétés correspondantes via leurs setters.

Exemple :

• Champ nom → méthode setNom()
• Champ date_de_naissance → méthode setDateDeNaissance()

Ce processus est automatique mais peut être personnalisé.

Formulaires Sans Objet

Un formulaire n’a pas nécessairement besoin d’être associé à un objet. Il peut fonctionner avec des tableaux.

Exemple :

$form = $this->createFormBuilder()
    ->add('mon_texte', TextType::class)
    ->add('ma_date', DateType::class)
    ->add('valider', SubmitType::class)
    ->getForm();

Les données soumises sont alors récupérées sous forme de tableau :

$donnees = $form->getData();

Représentation des Valeurs

Symfony gère trois types de représentations des données :

• View Data : Données affichées dans la vue (ex. : chaînes de caractères pour des dates).
• Model Data : Données du modèle associées à l’objet (ex. : objets DateTime pour des dates).
• Norm Data : Format intermédiaire standardisé.

Exemple avec le Type Date

Configurer le type de données en sortie (Model Data) :

$form = $this->createFormBuilder()
    ->add('ma_date', DateType::class, [
        'input' => 'timestamp'
    ])
    ->getForm();

Récupérer les différentes représentations :

$viewData = $form->get('ma_date')->getViewData(); // Données pour la vue
$normData = $form->get('ma_date')->getNormData(); // Données normalisées
$modelData = $form->get('ma_date')->getData(); // Données pour le modèle

 

1. Automatisation :
   • Mapping des données HTTP vers l’objet du modèle,
   • Gestion des erreurs et validation intégrée.
2. Extensibilité :
   • Ajout de types personnalisés,
   • Transformation et normalisation des données.
3. Flexibilité :
   • Peut être utilisé avec des objets ou des tableaux,
   • Champs configurables avec des options.
4. Intégration Facile avec Twig :
   • Rendu des formulaires simplifié grâce à la fonction form().

• Documentation Symfony Forms : Symfony Forms
• Types de Champs Symfony : Form Types Reference
• Validation Symfony : Validation

Le composant Form de Symfony est un outil essentiel pour gérer efficacement les formulaires. Il offre des fonctionnalités avancées de construction, validation et transformation des données tout en garantissant une forte intégration avec les couches Vue et Modèle. Maîtriser ses subtilités permet de développer des applications robustes et maintenables.