Guide d'installation Symfony

Bienvenue sur le guide d'installation pour le module MMI2 SYMFONY (2025/2026). Ce document regroupe toutes les commandes nécessaires pour configurer votre environnement de développement sous Windows en utilisant le sous-système Linux (WSL).

1. Préparation de l'environnement (WSL)

Pour installer notre projet, nous allons utiliser WSL (Windows Subsystem for Linux). Cela crée un environnement Linux (Ubuntu) sous Windows, nous donnant les droits nécessaires pour installer nos outils.

Étape 1 : Ouvrir le terminal

À l'aide de Git Bash ou PowerShell, placez-vous dans le répertoire système de Windows :

cd C:/Windows/System32

Étape 2 : Installer Ubuntu

Affichez la liste des distributions disponibles, puis installez la version recommandée (ex: Ubuntu 24.04).

wsl --list --online
wsl --install -d Ubuntu-24.04

Note importante : Une fois l'installation terminée, vous vous retrouverez dans un terminal Linux. Si vous n'êtes pas automatiquement dans votre dossier personnel, tapez cd /home pour vous y rendre.

2. Installation des dépendances

Une fois dans votre terminal Ubuntu (WSL), nous devons installer les paquets nécessaires : le serveur MySQL, PHP et ses extensions.

Mise à jour et MySQL

# Mettre à jour la liste des paquets
sudo apt update
sudo apt upgrade -y

# Installer le serveur de base de données
sudo apt install mysql-server -y

Installation de PHP

Symfony requiert PHP 8.2 (ou plus récent) ainsi que plusieurs extensions spécifiques (XML, Curl, Zip, Intl, etc.). Copiez la commande suivante :

sudo apt install php php-cli php-mysql php-xml php-mbstring php-curl php-zip php-intl -y

Pour vérifier que tout est correct, tapez php -v. La version affichée doit être au moins 8.2.

3. Installation de Composer

Composer est le gestionnaire de paquets de PHP. Il est indispensable pour installer Symfony et ses composants.

# Télécharger l'installateur
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"

# Exécuter l'installation
php composer-setup.php

# Déplacer l'exécutable pour le rendre global
sudo mv composer.phar /usr/local/bin/composer

Vérifiez l'installation en tapant composer --version.

4. Installation de la CLI Symfony

L'outil en ligne de commande (CLI) de Symfony permet de créer des projets et de lancer un serveur web local optimisé pour le développement.

Téléchargement

curl -fsSL https://get.symfony.com/cli/installer | bash

Configuration du PATH

Pour utiliser la commande symfony partout, ajoutez-la à votre configuration utilisateur :

echo 'export PATH="$HOME/.symfony5/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Tapez symfony -v pour confirmer que tout fonctionne.

5. Créer et Lancer un projet

Tout est prêt ! Nous allons créer une nouvelle application web nommée test-webapp.

Création de l'application

symfony new test-webapp

Lancement du serveur

cd test-webapp
symfony serve

Une fois le serveur lancé, ouvrez votre navigateur à l'adresse suivante :
http://localhost:8000

Si vous voyez la page d'accueil de Symfony, votre installation est réussie.

6. Astuces et Sauvegarde

Éditer vos fichiers

Vos fichiers se trouvent dans l'environnement WSL (\\wsl$\Ubuntu\home\...). Si vous utilisez VSCode, installez l'extension "Remote WSL" et tapez code . dans le dossier de votre projet pour l'ouvrir.

Sauvegarde obligatoire : Si vous travaillez sur les postes de l'IUT, votre environnement WSL est local et temporaire. Pensez à sauvegarder votre travail sur votre lecteur réseau (U:) à la fin de la séance.

# Sauvegarder vers le lecteur U (fin de séance)
cp -r /home/monprojet /mnt/u/

# Récupérer depuis le lecteur U (début de séance suivante)
cp -r /mnt/u/monprojet /home/