Comment Créer un Formulaire de Contact avec Symfony 7

03/03/2025
image d'une formulaire de contact pour symfony
Un formulaire de contact est essentiel pour permettre à vos visiteurs de vous contacter facilement. Symfony est un framework PHP robuste qui facilite la création de formulaires sécurisés et personnalisables. Dans cet article, je vais montrer la création d'un formulaire de contact simple avec Symfony 7.

Prérequis
Avant de commencer, vous devez avoir les outils suivants installés :

  • PHP 8.1 ou supérieur
  • Composer
  • Symfony CLI
  • Un serveur web local (comme Apache ou Nginx)
  • Une base de données (MySQL, PostgreSQL, etc.)

Installation de Symfony 7.2

Créer un Nouveau Projet Symfony :
   Ouvrez votre terminal et exécutez la commande suivante pour créer un nouveau projet Symfony de base :

composer create-project symfony/skeleton my_contact_project
cd my_contact_project

Installer les Dépendances Nécessaires :
   
Vous aurez besoin de quelques paquets supplémentaires pour gérer les formulaires et les emails :

composer require symfony/form symfony/mailer symfony/twig-bundle symfony/orm-pack

Création de l'Entité Contact

   Générer l'Entité :
   
Utilisez la console de votre IDE pour créer une nouvelle entité Contact :

php bin/console make:entity Contact
   Suivez les instructions pour ajouter les champs name, email, et message.

   Définir l'Entité :
   
Ouvrez le fichier src/Entity/Contact.php et définissez les propriétés et les attributs nécessaires :

namespace App\Entity;

use Doctrine\ORM\Mapping as ORM;
use Symfony\Component\Validator\Constraints as Assert;

#[ORM\Entity(repositoryClass: "App\Repository\ContactRepository")]
class Contact
{
    #[ORM\Id]
    #[ORM\GeneratedValue]
    #[ORM\Column(type: 'integer')]
    private ?int $id = null;

    #[ORM\Column(type: 'string', length: 100)]
    #[Assert\NotBlank]
    #[Assert\Length(min: 2, max: 100)]
    private ?string $name = null;

    #[ORM\Column(type: 'string', length: 255)]
    #[Assert\NotBlank]
    #[Assert\Email]
    private ?string $email = null;

    #[ORM\Column(type: 'text')]
    #[Assert\NotBlank]
    #[Assert\Length(min: 10)]
    private ?string $message = null;

    // Getters et setters

    public function getId(): ?int
    {
        return $this->id;
    }

    public function getName(): ?string
    {
        return $this->name;
    }

    public function setName(string $name): self
    {
        $this->name = $name;

        return $this;
    }

    public function getEmail(): ?string
    {
        return $this->email;
    }

    public function setEmail(string $email): self
    {
        $this->email = $email;

        return $this;
    }

    public function getMessage(): ?string
    {
        return $this->message;
    }

    public function setMessage(string $message): self
    {
        $this->message = $message;

        return $this;
    }
}

   Créer le Repository :
   
Symfony génère automatiquement un repository pour l'entité Contact. Vous pouvez le trouver dans src/Repository/ContactRepository.php.

   Mettre à Jour la Base de Données :

   
Exécutez les migrations pour mettre à jour votre base de données avec la nouvelle entité :

php bin/console make:migration
php bin/console doctrine:migrations:migrate

   Création du Formulaire de Contact

   
Ouvrez le fichier src/Form/ContactType.php et définissez les champs du formulaire :

Copiernamespace App\Form;

use Symfony\Component\Form\AbstractType;
use Symfony\Component\Form\Extension\Core\Type\EmailType;
use Symfony\Component\Form\Extension\Core\Type\TextareaType;
use Symfony\Component\Form\Extension\Core\Type\TextType;
use Symfony\Component\Form\FormBuilderInterface;
use Symfony\Component\OptionsResolver\OptionsResolver;

class ContactType extends AbstractType
{
    public function buildForm(FormBuilderInterface $builder, array $options): void
    {
        $builder
            ->add('name', TextType::class, [
                'label' => 'Nom',
            ])
            ->add('email', EmailType::class, [
                'label' => 'Email',
            ])
            ->add('message', TextareaType::class, [
                'label' => 'Message',
            ]);
    }

    public function configureOptions(OptionsResolver $resolver): void
    {
        $resolver->setDefaults([]);
    }
}

Traitement du Formulaire

   Créer un Contrôleur :
   
Générez un contrôleur pour gérer la soumission du formulaire :

php bin/console make:controller ContactController

   Configurer le Contrôleur :
   
Ouvrez src/Controller/ContactController.php et configurez-le pour traiter le formulaire :

namespace App\Controller;

use App\Entity\Contact;
use App\Form\ContactType;
use Doctrine\ORM\EntityManagerInterface;
use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\Routing\Annotation\Route;
use Symfony\Component\Mailer\MailerInterface;
use Symfony\Component\Mime\Email;

class ContactController extends AbstractController
{
    #[Route('/contact', name: 'contact')]
    public function index(Request $request, MailerInterface $mailer, EntityManagerInterface $entityManager): Response
    {
        $contact = new Contact();
        $form = $this->createForm(ContactType::class, $contact);
        $form->handleRequest($request);

        if ($form->isSubmitted() && $form->isValid()) {
            // Sauvegarder les données dans la base de données
            $entityManager->persist($contact);
            $entityManager->flush();

            // Envoi de l'email
            $email = (new Email())
                ->from($contact->getEmail())
                ->to('your-email@example.com')
                ->subject('Nouveau message de contact')
                ->text($contact->getMessage());

            $mailer->send($email);

            // Message de succès
            $this->addFlash('success', 'Votre message a été envoyé avec succès !');

            return $this->redirectToRoute('contact');
        }

        return $this->render('contact/index.html.twig', [
            'form' => $form->createView(),
        ]);
    }
}

Affichage du Formulaire dans une Vue

   Créer le Template Twig :

   
Un fichier dans  templates/contact/index.html.twig a été créé, ajoutez le code suivant pour afficher le formulaire :

{% extends 'base.html.twig' %}

{% block body %}
    <h1>Contactez-nous</h1>
    {{ form_start(form) }}
        {{ form_widget(form) }}
        <button class="btn btn-primary">Envoyer</button>
    {{ form_end(form) }}

    {% for message in app.flashes('success') %}
        <div class="alert alert-success">
            {{ message }}
        </div>
    {% endfor %}
{% endblock %}

   Sécurisation du Formulaire
   
Symfony inclut une protection CSRF par défaut pour les formulaires. Assurez-vous qu'elle est activée dans votre configuration.

   Validation Côté Serveur :
   
Toujours valider les données côté serveur pour éviter les injections SQL ou autres vulnérabilités.

Tests et Déploiement

   Écrire des Tests Unitaires :
   
Utilisez PHPUnit pour écrire des tests pour votre formulaire et votre contrôleur.

Conclusion

Vous avez maintenant un formulaire de contact fonctionnel créé avec Symfony 7.

0 Commentaire

Soyez le premier à commenter cet article !

Laisser un commentaire

Vous devez être connecté pour commenter.

Se connecter

Commentaires récents

Aucun commentaire pour le moment