Aller au contenu principal

Symfony avec DDEV

Installation d'un projet Symfony avec DDEV

Voici les étapes à suivre :

1. Cloner le projet​

Tout d'abord, clonez le projet Symfony depuis votre dépôt Git :

git clone <URL_DU_REPO> mon-projet-symfony
cd mon-projet-symfony

2. Configurer DDEV​

Initialisez DDEV dans le répertoire du projet :

ddev config --project-type=php --docroot=public --create-docroot

3. Personnaliser la configuration DDEV​

Éditez le fichier .ddev/config.yaml pour ajuster les versions de PHP et MySQL selon les besoins du projet.

Par exemple si votre projet a besoin de PHP 8.1 ou supérieur :

php_version: "8.1"
mysql_version: "8.0"
Résumé
  • Utilisez --project-type=php lors de la configuration de DDEV pour un projet Symfony.
  • Assurez-vous que le docroot est défini sur public, car c'est le répertoire Web par défaut pour Symfony.
  • Ajustez les versions de PHP et MySQL dans le fichier de configuration DDEV selon les besoins de votre projet.

4. Démarrer l'environnement DDEV​

Lancez l'environnement DDEV :

ddev start

5. Installer les dépendances​

Installez les dépendances du projet avec Composer :

ddev composer install

6. Configurer l'environnement Symfony​

Copiez le fichier .env en .env.local et ajustez les paramètres si nécessaire :

ddev exec cp .env .env.local

Éditez .env.local et assurez-vous que la configuration de la base de données est correcte.

La ligne de configuration de la variable d'environnement DATABASE_URL devrait ressembler à ceci :

DATABASE_URL="mysql://db:db@db:3306/db?serverVersion=8.0"

7. Créer la base de données​

Créez la base de données (si elle n'existe pas) :

ddev exec bin/console doctrine:database:create
Si erreur "bin/console: Permission denied"

  • ddev exec chmod 755 bin/console

8. Exécuter les migrations​

S'il y a des migrations, exécutez-les :

ddev exec bin/console doctrine:migrations:migrate
Si erreur "bin/console: Permission denied"

  • ddev exec chmod 755 bin/console

9. Charger les fixtures (si nécessaire)​

Si vous avez des fixtures, chargez-les :

ddev exec bin/console doctrine:fixtures:load
Si erreur "bin/console: Permission denied"

  • ddev exec chmod 755 bin/console

10. Compiler les assets​

Compilez les assets si nécessaire (selon votre configuration front-end) :

ddev exec yarn install # ou npm install
ddev exec yarn build # ou npm run build
Si erreur "Couldn't find a package.json file in "/var/www/html""

Cette erreur indique qu'il n'y a pas d'assets à construire.

Dans ce cas pour pouvez sautez l'étape "Compiler les assets".

11. Vérifier l'installation​

Ouvrez le projet dans votre navigateur :

ddev launch

Notes supplémentaires​

  • Assurez-vous que tous les services requis (comme Mailer) sont correctement configurés dans votre .env.local.
  • Si vous rencontrez des problèmes de permissions, vous pouvez utiliser ddev exec pour exécuter des commandes avec les bonnes permissions.
  • Pour utiliser la console Symfony, préfixez vos commandes avec ddev exec, par exemple : ddev exec bin/console cache:clear.

Votre projet Symfony devrait maintenant être opérationnel dans l'environnement DDEV.

astuce

Pour afficher les informations du projet (par exemple pour se connecter à la base de données dans le conteneur Docker), il suffit d'exécuter la commande :

ddev describe

Vous pouvez commencer à développer et à personnaliser votre application selon vos besoins.