Symfony : – Les formulaires « Fonctionnement »

Symfony

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()

      .

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.

Symfony