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 :
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.
É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.
Soyez le premier à commenter cet article !