Ce projet est un modèle de démarrage (template) conçu pour lancer un projet Symfony en quelques minutes, sans se soucier de la configuration de sa machine.
Pensez-y comme à un kit de développement « prêt-à-coder » : il contient tout ce qu’il faut (PHP, Apache, Composer, une base de données…) dans une boîte virtuelle (Docker), vous permettant de vous concentrer sur l’essentiel : le code.
Il est idéal pour les développeurs de tous niveaux, et particulièrement adapté aux étudiants qui découvrent l’écosystème Symfony et Docker.
Ce template configure un environnement complet et optimisé pour Symfony. Voici ce qu’il y a dans la boîte :
- Un serveur web complet avec PHP 8.2 et Apache.
- Composer 2 et le CLI Symfony pour gérer votre projet et ses dépendances.
- MySQL 8 prêt à l’emploi avec l’interface PhpMyAdmin pour gérer vos données facilement.
- Xdebug 3 pré-configuré pour déboguer votre code pas-à-pas comme un pro.
- Gestion automatique des permissions : Fini les
sudo chmod -R 777! Les fichiers créés dans le conteneur vous appartiendront sur votre machine, et vice-versa.
Avant de commencer, assurez-vous d'avoir les éléments suivants.
- Une installation fonctionnelle de Docker et Docker Compose (v2 ou supérieure).
Si c'est l'une de vos premières fois avec Git, il est crucial de configurer votre nom d'utilisateur et votre email. Chaque "commit" (sauvegarde) que vous ferez sera signé avec ces informations.
Exécutez ces commandes dans votre terminal en remplaçant les exemples par vos propres informations. L'option --global applique cette configuration à tous vos projets Git sur votre machine.
# Remplacez "Votre Nom" par votre vrai nom ou pseudo
git config --global user.name "Votre Nom"
# Remplacez par votre adresse email (celle de GitHub est un bon choix)
git config --global user.email "vous@exemple.com"La meilleure façon de commencer est d’utiliser ce dépôt comme modèle pour votre propre projet.
- Cliquez sur le bouton vert « Use this template » en haut de la page GitHub, puis sur « Create a new repository ».
- Choisissez un nom pour votre nouveau dépôt (ex :
mon-super-projet-symfony) et rendez-le public ou privé.
Une fois votre dépôt personnel créé, clonez-le sur votre machine locale et naviguez à l’intérieur :
# Remplacez <votre-nom-d-utilisateur> et <nom-du-depot>
git clone https://github.com/<votre-nom-d-utilisateur>/<nom-du-depot>.git
cd <nom-du-depot>Ce projet a besoin de connaître l’identifiant de votre utilisateur local (UID) et de son groupe (GID) pour éviter tout problème de permissions de fichiers avec Docker.
Un script est fourni pour automatiser cette configuration. Vous ne devez le lancer qu’une seule fois.
# Exécutez le script
./init.shQue fait ce script ? Il crée un fichier .env à la racine du projet et y inscrit votre UID et GID. Ce fichier sera ensuite lu par Docker Compose pour configurer les conteneurs avec les bonnes permissions. C’est la magie qui vous évitera les maux de tête de permissions !
💡 En cas d’erreur « Permission denied » ? Si le terminal refuse d’exécuter le script, lancez la commande
chmod +x init.shet réessayez.
Lancez l’ensemble des services (PHP, MySQL…) avec une seule commande. L’option -d (detached) permet de laisser les conteneurs tourner en arrière-plan.
docker compose up -d --buildLa première fois, Docker va télécharger les images nécessaires, ce qui peut prendre quelques minutes. Les lancements suivants seront quasi instantanés.
Vos conteneurs sont démarrés, mais le projet Symfony n’est pas encore là. Le répertoire app/ est vide. Nous allons maintenant utiliser les outils à l’intérieur de notre conteneur PHP pour y installer un nouveau projet Symfony.
docker compose exec --user www-data php symfony new . --webappdocker compose exec: Permet d’exécuter une commande dans un conteneur déjà en marche.--user www-data: Garantis que la commande sera exécutée en tant qu’utilisateurwww-data(celui du serveur web), afin que tous les fichiers créés aient les bonnes permissions.php: C’est le nom du service (conteneur) dans lequel on veut exécuter la commande, tel que défini dansdocker-compose.yml.symfony new . --webapp: C’est la commande pour créer un nouveau projet Symfony. Le.signifie qu’on l’installe dans le répertoire courant (/var/www/htmlà l’intérieur du conteneur, qui correspond à votre dossierapp/local).
Votre environnement est prêt ! Vous pouvez vérifier que tout fonctionne en visitant l’URL de votre projet.
- Site web : http://localhost:8000
- Base de données (PhpMyAdmin) : http://localhost:8080
Pour interagir avec votre projet (lancer des migrations, vider le cache, etc.), vous devrez toujours passer par docker compose exec.
Exemples :
# Lancer une commande de la console Symfony (ex: créer un contrôleur)
docker compose exec --user www-data php bin/console make:controller TestController
# Exécuter les migrations de base de données
docker compose exec --user www-data php bin/console doctrine:migrations:migrate
# Installer une dépendance avec Composer
docker compose exec --user www-data php composer require some-packagePour éviter de taper la longue commande docker compose exec... à chaque fois, vous pouvez créer un alias dans le fichier de configuration de votre terminal (~/.bashrc, ~/.zshrc, etc.).
# Ajoute un raccourci "sf" pour exécuter la console Symfony
alias sf='docker compose exec --user www-data php bin/console'Après avoir rechargé votre terminal, vous pourrez simplement faire :
sf make:controller TestController
sf doctrine:migrations:migrateCet environnement s’appuie sur une image Docker personnalisée, construite pour les besoins spécifiques des projets Symfony.
- Image :
manastria/symfony - Version utilisée par ce template : `8.2-apache-v0.0.1’
- Dépôt Docker Hub : hub.docker.com/r/manastria/symfony
La version de l’image est intentionnellement figée dans le fichier docker-compose.yml pour garantir que l’environnement soit stable et 100 % reproductible pour tous les développeurs du projet.
Ce projet est sous licence MIT. N’hésitez pas à l’utiliser, le modifier et le partager !