Mise en place de l'environnement

Pour le projet Symfony, nous allons tirer parti de PHPStorm et de ses fonctionnalités dédiées à Symfony. Cette fiche regroupe la mise en place complète de votre environnement de développement et les commandes à garder sous la main tout au long du module.

Fork du dépôt Git

Pour les ateliers comme pour l'évaluation, vous aurez à « forker » un dépôt Git.

Dépôt à forker : https://github.com/AdrienGras/2025-coda-projects

Pour forker un dépôt :

1. Allez sur la page du dépôt GitHub que vous souhaitez forker.
2. Cliquez sur le bouton « Fork » en haut à droite de la page.
3. Sélectionnez votre compte GitHub comme destination pour le fork.
4. Notez l'URL de votre dépôt GitHub.
5. Rapportez-la dans le fichier suivant, dans l'onglet correspondant.

Fichier : Annuaire des dépôts Git

Le projet Symfony se trouve dans le sous-dossier 005-bricount du dépôt.

Lancement de la stack Docker

Windows (WSL2)

Sous Windows, Docker tourne via WSL2 ; la procédure du premier lancement est un peu plus longue.

Premier lancement

Tout d'abord, nous allons nous assurer que WSL2 est bien installé et configuré.

1. Ouvrez PowerShell en mode administrateur (clic droit sur l'icône PowerShell > Exécuter en tant qu'administrateur).
2. Tapez la commande suivante pour vérifier que WSL est installé :

wsl --list --verbose

Si Ubuntu n'apparaît pas dans la liste, installez-le :

1. Ouvrez le Microsoft Store, recherchez « Ubuntu » et installez la dernière version disponible.
2. Une fois installé, lancez Ubuntu depuis le menu Démarrer et suivez les instructions pour créer un utilisateur et un mot de passe.

Maintenant que WSL2 est installé, nous allons cloner le dépôt dans le système de fichiers Linux.

1. Ouvrez l'explorateur de fichiers (icône de dossier dans la barre des tâches).
2. Dans le panneau de gauche, en bas, repérez « Linux » et dépliez-le.
3. Cliquez sur « Ubuntu » pour accéder au système de fichiers Linux.
4. Naviguez dans le dossier home/<votre-nom-d'utilisateur>/.
5. Si vous n'avez pas de dossier dédié à vos projets, créez-en un puis ouvrez-le.

Puis clonez le dépôt depuis le terminal Ubuntu :

1. Depuis le menu Démarrer, recherchez « Ubuntu » et lancez-le.
2. Dans le terminal, naviguez jusqu'au dossier créé précédemment. Par exemple :

cd ~/projects

3. Dans un navigateur, allez sur la page de votre dépôt forké et copiez l'URL (bouton « Code » > « HTTPS »).
4. Clonez le dépôt (remplacez <URL-du-dépôt> par l'URL copiée) :

git clone <URL-du-dépôt>

Lancez ensuite la stack Docker :

# placez-vous dans le dépôt puis dans le sous-dossier du projet
cd nom-du-dépôt/005-bricount

# premier lancement : build + attente que les conteneurs soient prêts
docker compose up -d --build --wait

Vérifiez que tout fonctionne en allant à l'adresse https://localhost:80.

Lancements suivants

1. Lancez PHPStorm et ouvrez le projet (voir Ouverture du projet).
2. Ouvrez un terminal dans PHPStorm (View > Tool Windows > Terminal).
3. Placez-vous dans le sous-dossier du projet puis lancez :

docker compose up -d

macOS / Linux

Placez-vous dans le dossier du projet (ex. 005-bricount) puis lancez la stack :

docker compose up -d --build --wait

Vérifiez que tout fonctionne en allant à l'adresse http://localhost:80.

Ajustements du fichier docker-compose.yml

Ouvrez le fichier docker-compose.yml à la racine du dossier du projet. Dans la section services > php > ports, si la notation commence par - name, remplacez-la par :

    ports:
      - "80:80"
      - "443:443"
      - "443:443/udp"

Enregistrez ensuite le fichier.

sudo chown -R $USER:$USER .

Ouverture du projet

Ouvrez PHPStorm, puis :

• Si vous êtes déjà dans un projet : File > Open, puis sélectionnez le dossier racine du dépôt > 005-bricount.
• Si vous n'êtes pas dans un projet : Open, puis sélectionnez le dossier racine du dépôt > 005-bricount.

Sous Windows (WSL2), le dépôt se trouve dans Linux > Ubuntu > home > <votre-nom-d'utilisateur> > <dossier-de-vos-projets>.

Configuration de PHPStorm

Configurer l'interpréteur PHP

Pour éviter d'installer PHP sur votre machine, nous allons utiliser l'interpréteur PHP fourni par Docker.

1. Allez dans File > Settings > Languages & Frameworks > PHP.
2. Cliquez sur les ... à côté du champ CLI Interpreter.
3. Cliquez sur le + en haut à gauche pour ajouter un nouvel interpréteur.
4. Sélectionnez From Docker, Vagrant, WSL, Remote....
5. Sélectionnez Docker Compose.
6. Si le champ Server est vide, cliquez sur les ... à côté, laissez les options par défaut, puis cliquez sur OK.
7. Dans le champ Configuration file, cliquez sur les ..., retirez tout le contenu existant et sélectionnez le fichier docker-compose.yml à la racine du projet (005-bricount/docker-compose.yml).
8. Dans le champ Service, sélectionnez php.
9. Cliquez sur OK pour valider l'ajout de l'interpréteur.
10. Cliquez sur Apply puis OK pour fermer la fenêtre des paramètres.

Installation des plugins

Pour tirer pleinement parti de l'expérience Symfony, installez plusieurs plugins via File > Settings > Plugins, puis cherchez et installez :

• Inspection Lens : affiche les erreurs/warnings/etc. au bout de la ligne de code.
• PHP Annotations : ajoute le support des annotations PHP.
• Rainbow Brackets : colore les paires de crochets, accolades et parenthèses.
• Symfony Plugin : support complet de Symfony (services, routes, etc.).
• Twig : support du moteur de templates Twig.
• Ideolog : visualisation facilitée des logs.
• SonarQube for IDE : analyse de la qualité du code.

Actions on Save

Allez dans File > Settings > Tools > Actions on Save et cochez Reformat code et Optimize imports pour que le code soit automatiquement formaté et les imports optimisés à chaque sauvegarde.

Accès à la base de données

Lorsque vous aurez besoin d'accéder à la base de données, vous vous connecterez directement à la base PostgreSQL du conteneur Docker depuis PHPStorm.

Vous trouverez les informations de connexion dans le fichier docker-compose.override.yml (ou docker-compose.yml) à la racine du projet 005-bricount.

1. Allez dans l'onglet Database de PHPStorm (généralement à droite de l'IDE).
2. Cliquez sur le + pour ajouter une nouvelle connexion, de type Postgres.
3. Renseignez la connexion avec les paramètres trouvés dans le fichier docker-compose.override.yml.
4. Cliquez sur Test Connection pour vérifier que tout fonctionne.
5. Cliquez sur OK pour enregistrer la connexion.

Changer de projet

Vos conteneurs Docker doivent être arrêtés avant de changer de projet, pour éviter les conflits de ports. Chaque stack Docker est dédiée à un seul projet et doit être gérée séparément.

# Rendez-vous dans le dossier du projet précédent
cd chemin/vers/dépôt/00X-projet-précédent

# Arrêtez les conteneurs Docker du projet précédent
docker compose down

# Rendez-vous dans le dossier du nouveau projet
cd ../0YY-nouveau-projet

# Lancez les conteneurs Docker du nouveau projet
docker compose up -d --build

Rappels — Git

Rappels — Docker