🏛️ Introduction à Symfony

Votre premier pas dans le framework PHP professionnel

Installation • Structure • Routing • Contrôleurs • Twig • Console

Formation DWWM - 2026

Au programme 📋

• 🎯 Qu'est-ce que Symfony ? (et pourquoi l'apprendre)
• 💾 Installation et configuration
• 📁 Structure d'un projet Symfony
• 🛣️ Le système de routing
• 🎮 Contrôleurs et réponses
• 🎨 Templates Twig
• ⌨️ Console Symfony
• 💡 Exemples pratiques

Qu'est-ce que Symfony ?

Comprendre avant de coder

C'est quoi Symfony ? 🏛️

Symfony est un framework PHP professionnel pour créer des applications web robustes et évolutives.

Pourquoi utiliser Symfony ? 💪

Symfony vs PHP pur 🆚

<?php
// Route manuelle
if ($_GET['page'] == 'home') {
    // Code home
}

// Requête BDD manuelle
$conn = mysqli_connect(...);
$result = mysqli_query($conn, 
    "SELECT * FROM users");

// Template manuel
echo "<h1>Titre</h1>";

// Sécurité manuelle
$input = htmlspecialchars($_POST['data']);
?>

<?php
// Route automatique
#[Route('/home', name: 'home')]

// ORM Doctrine
$users = $userRepository->findAll();

// Template Twig
return $this->render('home.html.twig');

// Sécurité intégrée
// CSRF, XSS, etc. gérés automatiquement
?>

Installation et Configuration

Mettre en place votre environnement

Prérequis 📋

Avant d'installer Symfony, vous avez besoin de :

Vérifier vos versions

# Vérifier PHP
php -v

# Vérifier Composer
composer -V

# Vérifier Symfony CLI
symfony -V

Installer Composer 📦

Composer est le gestionnaire de paquets de PHP (comme npm pour JavaScript).

Installation sur Windows

# Télécharger depuis https://getcomposer.org/
# Installer Composer-Setup.exe
# Redémarrer le terminal

Installation sur Mac/Linux

# Via le script officiel
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php
sudo mv composer.phar /usr/local/bin/composer

Créer un projet Symfony 🚀

Il existe 2 façons de créer un projet Symfony :

# Application web complète
composer create-project \
  symfony/skeleton mon-projet

cd mon-projet

# Plus rapide et moderne
symfony new mon-projet

cd mon-projet

Que se passe-t-il pendant l'installation ?

1. Téléchargement des fichiers
   Composer télécharge Symfony et ses dépendances
2. Création de la structure
   Les dossiers (src/, config/, public/...) sont créés
3. Configuration initiale
   Les fichiers de config de base sont générés
4. Installation des dépendances
   Les composants essentiels sont installés

Démarrer le serveur de développement 🌐

Symfony inclut un serveur web de développement intégré.

Avec Symfony CLI (recommandé)

# Démarrer le serveur
symfony serve

# Le serveur démarre sur https://127.0.0.1:8000
# Ou http://localhost:8000

Avec PHP (alternatif)

# Démarrer avec PHP built-in server
php -S localhost:8000 -t public/

Structure d'un projet Symfony

Comprendre l'organisation des fichiers

L'arborescence complète 🌳

mon-projet/
├── bin/                  # Scripts exécutables
│   └── console          # Console Symfony (commandes)
├── config/              # 📋 Configuration de l'app
│   ├── packages/        # Config des bundles
│   ├── routes.yaml      # Définition des routes
│   └── services.yaml    # Services et dépendances
├── public/              # 🌐 Racine web publique
│   └── index.php        # Point d'entrée de l'app
├── src/                 # 💻 TON CODE ICI !
│   ├── Controller/      # Contrôleurs
│   ├── Entity/          # Entités (modèles)
│   └── Repository/      # Accès base de données
├── templates/           # 🎨 Vues Twig
├── var/                 # Fichiers temporaires
│   ├── cache/           # Cache
│   └── log/             # Logs
├── vendor/              # 📦 Dépendances (ne pas modifier)
├── .env                 # Variables d'environnement
└── composer.json        # Dépendances du projet

Les dossiers expliqués en détail 📁

📂 src/ - Votre code

C'est ici que VOUS allez travailler !

📂 config/ - Configuration

Fichiers de configuration de l'application.

📂 public/ - Fichiers publics

Seul dossier accessible depuis Internet. Contient CSS, JS, images et index.php.

📂 templates/ - Vues HTML

Vos fichiers Twig (HTML avec des super-pouvoirs).

public/index.php - Le point d'entrée unique 🚪

TOUTES les requêtes passent par ce fichier unique !

Flux d'une requête

Le système de Routing

Relier les URLs aux contrôleurs

C'est quoi le routing ? 🛣️

Le routing associe une URL à un contrôleur (fonction PHP).

Exemple simple

Créer une route (méthode moderne) 🎯

Depuis Symfony 6, on utilise les attributs PHP pour définir les routes.

Exemple complet

<?php
namespace App\Controller;

use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\Routing\Attribute\Route;

class HomeController extends AbstractController
{
    #[Route('/', name: 'home')]
    public function index(): Response
    {
        return new Response('Bienvenue sur mon site !');
    }
}

Décomposition ligne par ligne

1. #[Route('/', name: 'home')]
   C'est l'attribut de route. Il dit : "Quand on accède à /, exécute la fonction en dessous"
2. '/'
   L'URL (ici la racine du site)
3. name: 'home'
   Le nom de la route (pour la retrouver facilement)
4. public function index()
   La fonction qui sera exécutée
5. return new Response(...)
   On retourne une réponse HTTP

Routes avec paramètres 📝

On peut capturer des valeurs dynamiques dans l'URL !

Exemple : Page utilisateur

<?php
#[Route('/user/{id}', name: 'user_show')]
public function show(int $id): Response
{
    return new Response("Affichage de l'utilisateur n°" . $id);
}

// URL : /user/123
// Affiche : Affichage de l'utilisateur n°123

Comment ça marche ?

Avec plusieurs paramètres

#[Route('/blog/{category}/{slug}', name: 'blog_post')]
public function post(string $category, string $slug): Response
{
    return new Response(
        "Catégorie: $category, Article: $slug"
    );
}

// URL : /blog/tech/symfony-tutorial
// Affiche : Catégorie: tech, Article: symfony-tutorial

Contraintes sur les paramètres 🔒

On peut forcer un paramètre à respecter un format !

Exemple : ID doit être un nombre

#[Route('/user/{id}', name: 'user_show', requirements: ['id' => '\d+'])]
public function show(int $id): Response
{
    // $id sera TOUJOURS un nombre
}

// ✅ /user/123 → Fonctionne
// ❌ /user/abc → Erreur 404

Contraintes courantes

Les Contrôleurs

Le cerveau de votre application

C'est quoi un contrôleur ? 🎮

Un contrôleur est une classe PHP qui contient la logique métier de votre application.

Rôle d'un contrôleur

1. Recevoir la requête
   Récupère les données de l'URL, du formulaire, etc.
2. Traiter
   Appelle des services, interroge la BDD, effectue des calculs
3. Retourner une réponse
   Génère du HTML, JSON, PDF, etc.

Créer un contrôleur 🏗️

Avec la console Symfony (recommandé)

php bin/console make:controller HomeController

Cette commande crée automatiquement :

• 📄 src/Controller/HomeController.php
• 📄 templates/home/index.html.twig

Code généré

<?php
namespace App\Controller;

use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\Routing\Attribute\Route;

class HomeController extends AbstractController
{
    #[Route('/home', name: 'app_home')]
    public function index(): Response
    {
        return $this->render('home/index.html.twig', [
            'controller_name' => 'HomeController',
        ]);
    }
}

Types de réponses possibles 📤

1. Réponse texte simple

return new Response('Hello World!');

2. Réponse HTML (template Twig)

return $this->render('home/index.html.twig', [
    'titre' => 'Ma page d\'accueil',
    'date' => new DateTime()
]);

3. Réponse JSON (pour API)

return $this->json([
    'message' => 'Success',
    'data' => ['id' => 123, 'name' => 'Marie']
]);

4. Redirection

// Redirection vers une URL
return $this->redirectToRoute('home');

// Redirection vers une URL externe
return $this->redirect('https://google.com');

5. Fichier à télécharger

return $this->file('/path/to/document.pdf');

Récupérer les données de la requête 📥

Symfony injecte automatiquement l'objet Request !

Paramètres GET

use Symfony\Component\HttpFoundation\Request;

#[Route('/search', name: 'search')]
public function search(Request $request): Response
{
    // URL: /search?q=symfony
    $query = $request->query->get('q');
    
    return new Response("Recherche pour: " . $query);
}

Paramètres POST (formulaire)

#[Route('/login', name: 'login', methods: ['POST'])]
public function login(Request $request): Response
{
    $email = $request->request->get('email');
    $password = $request->request->get('password');
    
    // Traiter le login...
}

Headers HTTP

$userAgent = $request->headers->get('User-Agent');
$acceptLanguage = $request->headers->get('Accept-Language');

Templates Twig

Générer du HTML dynamique

C'est quoi Twig ? 🎨

Twig est le moteur de templates de Symfony. Il permet de générer du HTML de manière élégante et sécurisée.

<h1><?php echo htmlspecialchars($titre); ?></h1>
<?php foreach($users as $user): ?>
    <p><?php echo $user['name']; ?></p>
<?php endforeach; ?>

<h1>{{ titre }}</h1>
{% for user in users %}
    <p>{{ user.name }}</p>
{% endfor %}

Syntaxe Twig de base 📝

Exemples d'utilisation

{# Afficher une variable #}
<h1>Bonjour {{ prenom }} !</h1>

{# Condition #}
{% if age >= 18 %}
    <p>Vous êtes majeur</p>
{% else %}
    <p>Vous êtes mineur</p>
{% endif %}

{# Boucle #}
<ul>
{% for item in items %}
    <li>{{ item }}</li>
{% endfor %}
</ul>

Passer des variables au template 📦

Dans le contrôleur, on passe un tableau de variables :

Contrôleur

#[Route('/blog', name: 'blog')]
public function blog(): Response
{
    $articles = [
        ['titre' => 'Article 1', 'auteur' => 'Marie'],
        ['titre' => 'Article 2', 'auteur' => 'Paul'],
        ['titre' => 'Article 3', 'auteur' => 'Sophie']
    ];
    
    return $this->render('blog/index.html.twig', [
        'articles' => $articles,
        'siteName' => 'Mon Blog',
        'year' => 2025
    ]);
}

Template (blog/index.html.twig)

<h1>{{ siteName }}</h1>

{% for article in articles %}
    <article>
        <h2>{{ article.titre }}</h2>
        <p>Par {{ article.auteur }}</p>
    </article>
{% endfor %}

<footer>
    <p>© {{ year }} {{ siteName }}</p>
</footer>

Héritage de templates 🧬

Créer un layout de base et le réutiliser !

1. Créer le layout de base (templates/base.html.twig)

<!DOCTYPE html>
<html>
<head>
    <title>{% block title %}Mon Site{% endblock %}</title>
</head>
<body>
    <header>
        <h1>Mon Super Site</h1>
        <nav>...</nav>
    </header>
    
    <main>
        {% block content %}{% endblock %}
    </main>
    
    <footer>
        <p>© 2025 Mon Site</p>
    </footer>
</body>
</html>

2. Étendre le layout (templates/blog/index.html.twig)

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

{% block title %}Mon Blog{% endblock %}

{% block content %}
    <h2>Bienvenue sur mon blog !</h2>
    {% for article in articles %}
        <article>{{ article.titre }}</article>
    {% endfor %}
{% endblock %}

Filtres Twig 🔧

Les filtres transforment les variables avant affichage.

Filtres courants

Chaîner les filtres

{{ description|striptags|slice(0, 100)|upper }}

Étapes :
1. striptags → retire les balises HTML
2. slice(0, 100) → garde 100 premiers caractères
3. upper → convertit en majuscules

La Console Symfony

Votre outil en ligne de commande

C'est quoi la console Symfony ? ⌨️

La console est un outil en ligne de commande pour gérer votre application.

Comment utiliser la console ?

# Format général
php bin/console nom:commande [options] [arguments]

# Exemple
php bin/console make:controller HomeController

Commandes essentielles 🛠️

Aide sur une commande

php bin/console help make:controller

# Affiche :
# - Description de la commande
# - Options disponibles
# - Exemples d'utilisation

debug:router - Voir toutes vos routes 🗺️

Cette commande liste toutes les routes de votre application.

Utilisation

php bin/console debug:router

Résultat

 Name        Method   Path            Controller
-----------------------------------------------------
 home        ANY      /               App\Controller\HomeController::index
 blog        GET      /blog           App\Controller\BlogController::index
 blog_show   GET      /blog/{id}      App\Controller\BlogController::show
 contact     ANY      /contact        App\Controller\ContactController::index

Chercher une route spécifique

php bin/console debug:router blog

# Affiche uniquement la route "blog" avec tous ses détails

Exemples Pratiques

Mettre en pratique

Exemple 1 : Page d'accueil simple 🏠

1. Créer le contrôleur

php bin/console make:controller HomeController

2. Modifier le contrôleur (src/Controller/HomeController.php)

<?php
namespace App\Controller;

use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\Routing\Attribute\Route;

class HomeController extends AbstractController
{
    #[Route('/', name: 'home')]
    public function index(): Response
    {
        return $this->render('home/index.html.twig', [
            'siteName' => 'Mon Super Site',
            'year' => date('Y')
        ]);
    }
}

3. Créer le template (templates/home/index.html.twig)

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

{% block title %}Accueil - {{ siteName }}{% endblock %}

{% block body %}
    <h1>Bienvenue sur {{ siteName }} !</h1>
    <p>Ceci est ma première page Symfony.</p>
    
    <footer>
        <p>© {{ year }} {{ siteName }}</p>
    </footer>
{% endblock %}

Exemple 2 : Liste d'articles de blog 📰

Contrôleur (src/Controller/BlogController.php)

<?php
namespace App\Controller;

use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\Routing\Attribute\Route;

class BlogController extends AbstractController
{
    #[Route('/blog', name: 'blog_index')]
    public function index(): Response
    {
        // En vrai, ces données viendraient de la base de données
        $articles = [
            [
                'id' => 1,
                'titre' => 'Découvrir Symfony',
                'auteur' => 'Marie Dupont',
                'date' => new \DateTime('2025-01-15'),
                'resume' => 'Introduction au framework Symfony...'
            ],
            [
                'id' => 2,
                'titre' => 'Les bases de Twig',
                'auteur' => 'Paul Martin',
                'date' => new \DateTime('2025-01-20'),
                'resume' => 'Apprendre à utiliser Twig...'
            ],
            [
                'id' => 3,
                'titre' => 'Doctrine ORM',
                'auteur' => 'Sophie Bernard',
                'date' => new \DateTime('2025-01-25'),
                'resume' => 'Gérer vos bases de données...'
            ]
        ];
        
        return $this->render('blog/index.html.twig', [
            'articles' => $articles
        ]);
    }
    
    #[Route('/blog/{id}', name: 'blog_show', requirements: ['id' => '\d+'])]
    public function show(int $id): Response
    {
        // En vrai, on récupérerait l'article depuis la BDD
        return $this->render('blog/show.html.twig', [
            'articleId' => $id
        ]);
    }
}

Template liste (templates/blog/index.html.twig)

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

{% block title %}Blog{% endblock %}

{% block body %}
    <h1>Articles du Blog</h1>
    
    <div class="articles">
        {% for article in articles %}
            <article>
                <h2>
                    <a href="{{ path('blog_show', {id: article.id}) }}">
                        {{ article.titre }}
                    </a>
                </h2>
                <p class="meta">
                    Par {{ article.auteur }} 
                    le {{ article.date|date('d/m/Y') }}
                </p>
                <p>{{ article.resume }}</p>
            </article>
        {% else %}
            <p>Aucun article pour le moment.</p>
        {% endfor %}
    </div>
{% endblock %}

Exemple 3 : Formulaire de contact 📧

Contrôleur

<?php
namespace App\Controller;

use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\Routing\Attribute\Route;

class ContactController extends AbstractController
{
    #[Route('/contact', name: 'contact')]
    public function index(Request $request): Response
    {
        $message = null;
        
        // Si le formulaire a été soumis
        if ($request->isMethod('POST')) {
            $nom = $request->request->get('nom');
            $email = $request->request->get('email');
            $sujet = $request->request->get('sujet');
            $texte = $request->request->get('message');
            
            // En vrai, on enverrait un email ici
            $message = "Merci $nom, votre message a été envoyé !";
        }
        
        return $this->render('contact/index.html.twig', [
            'message' => $message
        ]);
    }
}

Template (templates/contact/index.html.twig)

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

{% block title %}Contact{% endblock %}

{% block body %}
    <h1>Contactez-nous</h1>
    
    {% if message %}
        <div class="alert success">{{ message }}</div>
    {% endif %}
    
    <form method="POST">
        <div>
            <label>Nom :</label>
            <input type="text" name="nom" required>
        </div>
        
        <div>
            <label>Email :</label>
            <input type="email" name="email" required>
        </div>
        
        <div>
            <label>Sujet :</label>
            <input type="text" name="sujet" required>
        </div>
        
        <div>
            <label>Message :</label>
            <textarea name="message" required></textarea>
        </div>
        
        <button type="submit">Envoyer</button>
    </form>
{% endblock %}

Flux complet d'une requête Symfony 🌊

Récapitulons le parcours complet d'une requête HTTP dans Symfony :

1. L'utilisateur clique sur un lien
   Exemple : http://localhost:8000/blog/5
2. Le serveur web reçoit la requête
   Apache/Nginx redirige vers public/index.php
3. index.php charge Symfony
   Le framework démarre et initialise tous ses composants
4. Le Router analyse l'URL
   Il cherche quelle route correspond à /blog/5
5. Le Router trouve la route
   Route: /blog/{id} → BlogController::show()
6. Le Contrôleur est exécuté
   BlogController::show(5) s'exécute avec id=5
7. Le Contrôleur traite
   Récupère les données, fait les calculs nécessaires
8. Le Template est rendu
   Twig génère le HTML avec les données
9. La Response est retournée
   Le HTML est envoyé au navigateur de l'utilisateur
10. Le navigateur affiche la page
    L'utilisateur voit la page !

Ce qu'on a appris

Résumé complet 📚

Structure du projet - Rappel 📁

Commandes à retenir 🛠️

Bonnes pratiques 💡

1. Utilise toujours les attributs pour les routes
   C'est plus moderne et plus lisible que YAML
2. Un contrôleur = une responsabilité
   Ne mets pas tout dans HomeController
3. Hérite toujours de AbstractController
   Tu bénéficies des méthodes utiles (render, json...)
4. Utilise Twig pour TOUT le HTML
   Ne mélange jamais PHP et HTML directement
5. Nomme tes routes
   Toujours mettre name: 'route_name'
6. Utilise la console
   make:controller, make:entity... gagnent du temps
7. Vide le cache si ça bug
   php bin/console cache:clear résout souvent les problèmes

Prochaines étapes 🚀

Maintenant que tu connais les bases, voici ce qu'il faut apprendre ensuite :

Ressources utiles 📖

Erreurs courantes (et comment les éviter) ⚠️

Exercices pratiques 💪

Pour bien assimiler, voici des exercices à faire :

🎓 Bravo !

Tu as terminé l'introduction à Symfony

Continue à pratiquer ! 💪

Formation DWWM - 2026