<-

Retour

Symfony 6: Introduction

Symfony 6: Introduction

Ce support de cours vous fournira une introduction complète au Framework Symfony.

Vous découvrirez comment installer et configurer Symfony sur votre machine, ainsi que les principes fondamentaux, son architecture et la manière de configurer votre environnement de développement.

0

Partager sur twitterPartager sur FacebookPartager sur LinkdinPartager sur Telegram

Ce support de cours vous fournira une introduction complète au Framework Symfony.

Vous découvrirez les principes fondamentaux de Symfony, son architecture et la manière de configurer votre environnement de développement.


Plan du cours

  1. Présentation du Framework Symfony

    1. Installation
    2. Configuration de l'environnement de développement
  2. Créer un projet Symfony

    1. Initialisation avec symfony-cli
    2. Initialisation avec composer
  3. Structure d'une application Symfony

    1. Organisation des fichiers et répertoires dans une application Symfony
    2. Architecture MVC (Modèle-Vue-Contrôleur)
    3. Composants clés de Symfony

Objectifs

  • Comprendre les concepts clés et l'architecture de Symfony.
  • Savoir installer Symfony et configurer l'environnement de développement.
  • Connaître la structure d'une application Symfony et l'organisation des fichiers.

1. Installation

Avant de commencer à développer avec Symfony, il est essentiel d'installer le Framework et de le configurer correctement.


Symfony peut être installé via Composer, Symfony CLI ou en téléchargeant l'archive officielle depuis le site web de Symfony .


1.1. PHP

Si vous voulez utiliser la version 6 de Symfony, il faut au minimum installer la version 8 de PHP.

1.1.1. Installation de PHP sur Windows

  1. Téléchargement de PHP
    • Accédez au site officiel de PHP.
    • Sous la section Windows Downloads, téléchargez le fichier d'installation adapté à votre version de Windows.



  1. Configuration de PHP
    • Une fois le téléchargement terminé, ouvrez le fichier exécutable et suivez les instructions de l'assistant d'installation.
    • Sélectionnez Installation type et choisissez Full pour installer PHP avec tous les composants nécessaires.
    • Sélectionnez le répertoire d'installation de votre choix (par défaut, il est recommandé de le conserver dans le répertoire C:\php).
    • Cochez l'option Add PHP to system PATH pour ajouter PHP à la variable d'environnement PATH de Windows.
    • Cliquez sur Next et suivez les instructions pour terminer l'installation.



  1. Vérification de l'installation
    • Fermez et rouvrez l'invite de commandes (cmd.exe).
    • Tapez la commande php -v pour vérifier la version de PHP installée.
    • Vous devriez voir les détails de la version de PHP s'afficher, ce qui confirme que l'installation a été réussie.

1.1.2. Installation de PHP sur Mac

  1. Installation de Homebrew (gestionnaire de paquets)
    • Ouvrez Terminal, l'application de ligne de commande par défaut sur macOS.
    • Exécutez la **commande **suivante et appuyez sur Enter :
      /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
      
    • Suivez les instructions à l'écran pour terminer l'installation de Homebrew.



  1. Installation de PHP
    • Dans Terminal, exécutez la commande suivante pour installer PHP :
    brew install php
    
    • Homebrew téléchargera et installera la dernière version de PHP.



  1. Vérification de l'installation
    • Fermez et rouvrez le terminal pour prendre en compte les modifications.
    • Dans Terminal, tapez la commande php -v pour vérifier la version de PHP installée.
    • Les détails de la version de PHP devraient s'afficher si l'installation a réussi.

1.1.3. Installation de PHP sur Linux

  1. Installation de PHP
    • Ouvrez le terminal.
    • Exécutez la commande d'installation appropriée selon votre distribution Linux (Pour Ubuntu/Debian):
    sudo apt update
    sudo apt install php
    



  1. Vérification de l'installation
    • Fermez et rouvrez le terminal pour prendre en compte les modifications.
    • Dans Terminal, tapez la commande php -v pour vérifier la version de PHP installée.
    • Les détails de la version de PHP devraient s'afficher si l'installation a réussi.


1.2. Composer

Symfony peut être installé de différentes manières, mais l'approche recommandée est d'utiliser Composer, un gestionnaire de dépendances pour PHP.


Composer permet d'installer Symfony et ses dépendances de manière automatisée.


1.2.1. Installation de Composer sur Windows

  1. Téléchargement de Composer
    • Accédez au site officiel de Composer.
    • Sous la section "Windows", cliquez sur le lien de téléchargement correspondant à la version de Composer souhaitée (par exemple, Composer-Setup.exe).



  1. Installation de Composer
    • Une fois le téléchargement terminé, exécutez le fichier Composer-Setup.exe.
    • L'assistant d'installation de Composer s'ouvrira. Suivez les instructions à l'écran pour terminer l'installation.
    • Par défaut, Composer sera installé dans le répertoire C:\ProgramData\ComposerSetup\bin. Vous pouvez modifier le répertoire d'installation si nécessaire.



  1. Vérification de l'installation
    • Fermez et rouvrez l'invite de commandes (cmd.exe).
    • Tapez la commande composer --version pour vérifier si Composer a été installé avec succès.
    • Les détails de la version de Composer devraient s'afficher si l'installation a réussi.

1.2.2 Installation de Composer sur Mac

  1. Installation de Composer via Homebrew
    • Ouvrez Terminal, l'application de ligne de commande par défaut sur macOS.
    • Exécutez la commande suivante et appuyez sur Enter :
      brew install composer
      
    • Homebrew téléchargera et installera Composer.



  1. Vérification de l'installation
    • Fermez et rouvrez le terminal pour prendre en compte les modifications.
    • Dans Terminal, tapez la commande composer --version pour vérifier si Composer a été installé avec succès.
    • Les détails de la version de Composer devraient s'afficher si l'installation a réussi.

1.2.3 Installation de Composer sur Linux

  1. Installation de Composer via le script d'installation
    • Ouvrez le terminal.
    • Exécutez la commande suivante pour télécharger le script d'installation de Composer :
      php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
      
    • Ensuite, exécutez la commande suivante pour vérifier l'intégrité du script téléchargé :
      php -r "if (hash_file('sha384', 'composer-setup.php') === 'baf1608c33254d00611ac1705c1d9958c817a1a33bce370c0595974b342601bd80b92a3f46067da89e3b06bff421f182') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
      
    • Si l'intégrité est vérifiée, exécutez la commande suivante pour installer Composer globalement :
      sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer
      
    • Vous pouvez également installer Composer localement en remplaçant --install-dir=/usr/local/bin par le répertoire de votre choix.



  1. Vérification de l'installation
    • Fermez et rouvrez le terminal pour prendre en compte les modifications.
    • Dans le terminal, tapez composer --version pour vérifier si Composer a été installé avec succès.
    • Les détails de la version de Composer devraient s'afficher si l'installation a réussi.


1.3. Symfony-cli

Symfony CLI est un outil en ligne de commande qui facilite le développement et l'administration d'applications Symfony.

1.3.1. Installation de Symfony-cli sur Windows

  1. Installer scoop
    • Accédez au site officiel de Scoop.
    • Ouvrez un terminal PowerShell.
    • Entrez la commande permettant d'exécuter des scripts :
      Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
      
    • Puis la commande pour lancer le script d'installation de scoop :
      irm get.scoop.sh | iex
      



  1. Installation de symfony-cli
    • Installer la CLI en exécutant la commande :
      scoop install symfony-cli
      



  1. Vérification de l'installation
    • Fermez et rouvrez le terminal pour prendre en compte les modifications.
    • Tapez la commande symfony --version pour vérifier si Symfony CLI a été installé avec succès.
    • Les détails de la version de Symfony CLI devraient s'afficher si l'installation a réussi.

3.2 Installation de Symfony-cli sur Mac

  1. Installationde Symfony-cli via Homebrew
    • Ouvrez Terminal, l'application de ligne de commande par défaut sur macOS.
    • Exécutez la commande suivante et appuyez sur Enter :
      brew install symfony
      
    • Homebrew téléchargera et installera Symfony CLI.



  1. Vérification de l'installation
    • Fermez et rouvrez le terminal pour prendre en compte les modifications.
    • Dans Terminal, tapez la commande symfony --version pour vérifier si Symfony CLI a été installé avec succès.
    • Les détails de la** version** de Symfony CLI devraient s'afficher si l'installation a réussi.

3.3 Installation de Symfony-cli sur Linux

  1. Installation de Symfony-cli via le script d'installation
    • Ouvrez le terminal.
    • Exécutez la commande suivante pour télécharger le script d'installation de Symfony CLI :
      wget https://get.symfony.com/cli/installer -O - | bash
      



  1. Configuration de Symfony CLI
    • Exécutez la commande suivante pour déplacer Symfony CLI vers un emplacement accessible dans le système :
      sudo mv /home/votre_nom_utilisateur/.symfony/bin/symfony /usr/local/bin/symfony
      
    • Assurez-vous de remplacer /home/votre_nom_utilisateur/ par le chemin vers votre répertoire d'accueil.



  1. Vérification de l'installation
    • Fermez et rouvrez le terminal pour prendre en compte les modifications.
    • Dans le terminal, tapez composer --version pour vérifier si Composer a été installé avec succès.
    • Les détails de la version de Composer devraient s'afficher si l'installation a réussi.


2. Configuration de l'environnement

Une fois Symfony installé, vous devez configurer votre environnement de développement pour travailler efficacement.


Cela peut inclure la configuration d'un serveur web local tel que Apache ou Nginx, la configuration de la base de données et l'installation d'autres outils utiles tels que l'interface graphique MySQL et un éditeur de code adapté au développement web.


La configuration de l'environnement est essentielle pour créer un flux de travail fluide et productif.



3. Créer un projet

Maintenant que l'environnement est configuré, nous allons voir comment créer et initialiser un projet Symfony.


Ouvrez un terminal dans le dossier où vous souhaitez avoir votre projet.


3.1 Initialisation avec Symfony-cli

Pour créer un projet avec Symfony CLI, il suffit de lancer la commande :


symfony new MonProjet

Ou MonProjet est le nom de votre projet.


3.2 Initialisation avec Composer

Pour créer un projet avec Composer, il suffit de lancer la commande :


composer create-project symfony/skeleton MonProjet

Ou MonProjet est le nom de votre projet.


4. Structure d'une application

Symfony suit une structure bien définie pour les applications web.


Vous découvrirez la structure des répertoires tels que :


  • src pour le code source de votre application
  • config pour les fichiers de configuration
  • templates pour les vues
  • public pour les ressources accessibles publiquement

Comprendre cette structure vous aidera à naviguer et à organiser vos fichiers de manière cohérente.


Nous explorerons en détail l'organisation des fichiers et répertoires dans une application Symfony.


4.1 Architecture MVC

Cette structure est basée sur l'architecture MVC (Modèle-Vue-Contrôleur) qui favorise la séparation des préoccupations et la modularité du code.


L'architecture MVC est un patron de conception couramment utilisé dans le développement web.


Nous vous présenterons les trois composants clés de l'architecture MVC : le modèle, la vue et le contrôleur.


Le modèle représente les données et la logique métier de l'application, le contrôleur gère les interactions utilisateur et coordonne les actions à effectuer, tandis que la vue est responsable de l'affichage des données à l'utilisateur.


Vous apprendrezplacer vos fichiers de contrôleurs, vos modèles, vos vues et autres éléments spécifiques à votre application.


Comprendre cette organisation facilitera la maintenance et l'extension de votre application Symfony.


4.2 Composants clés

Symfony fournit des composants puissants qui facilitent la mise en œuvre de l'architecture MVC.


Nous nous concentrerons sur quelques composants clés tels que :


  • Le système de routage, qui permet de mapper les URLs aux actions des contrôleurs.
  • Le noyau HTTP (HTTP Kernel), qui gère les requêtes et les réponses HTTP.
  • Le gestionnaire d'événements (Event Dispatcher), qui permet de créer des flux d'événements personnalisés.

5. Lancer l'application

Vous pouvez vérifier si votre environnement est bien configuré en utilisant la commande :


symfony check:requirements

5.1. Lancer l'application avec log

Pour lancer le serveur et accéder à l'application via le navigateur tout en affichant les logs dans votre terminal, lancez la commande :


symfony server:start

Vous pouvez ensuite y accéder à l'application localement en utilisant l'URL http://localhost:8000/.


5.2. Lancer l'application sans log

Pour lancer le serveur et accéder à l'application en mode background ou détachée, vous pouvez utiliser la commande :


symfony server:start -d

Vous pouvez ensuite y accéder à votre application en utilisant l'URL http://localhost:8000/.


5.3. Stopper l'application

Pour arrêter le serveur, vous pouvez utiliser la commande :


symfony server:stop


Conclusion

Vous connaissez maintenant les différentes méthodes d'installation et de configuration de Symfony, ainsi que la création et l'initialisation d'un projet Symfony.


Pour approfondir vos connaissances sur Symfony, voici quelques liens utiles :




Aller plus loin

Le prochain support de cours couvrira en détail les fondamentaux de Symfony, y compris le système de routage, les contrôleurs et les actions.


Commentaires

IsLoading