Environnement DDEV

DDEV est un outil de développement local basé sur Docker. Il crée des environnements isolés et reproductibles, parfaits pour le développement Drupal.

🔧 Prérequis DDEV

1. Docker

DDEV nécessite Docker pour fonctionner.

# Installer Docker Desktop
brew install --cask docker

# OU télécharger depuis https://www.docker.com/products/docker-desktop

# Lancer Docker Desktop et attendre qu'il soit prêt
# L'icône Docker doit être stable dans la barre de menu

# Ubuntu/Debian
sudo apt-get update
sudo apt-get install docker.io docker-compose-plugin
sudo systemctl start docker
sudo systemctl enable docker

# Ajouter votre utilisateur au groupe docker
sudo usermod -aG docker $USER
# Déconnectez-vous et reconnectez-vous

2. Installer DDEV

# Avec Homebrew
brew install ddev/ddev/ddev

# Configurer le provider DNS
mkcert -install

# Avec Chocolatey (en tant qu'administrateur)
choco install ddev

# OU avec l'installateur
# Télécharger depuis https://github.com/ddev/ddev/releases

# Script d'installation officiel
curl -fsSL https://raw.githubusercontent.com/ddev/ddev/master/scripts/install_ddev.sh | bash

# Installer mkcert pour HTTPS local
mkcert -install

3. Vérifier l’installation

ddev version

Vous devriez voir quelque chose comme :

DDEV version v1.23.x
docker version 24.x.x
docker-compose version v2.x.x

🚀 Créer un projet Drupal avec DDEV

Créer le dossier du projet
Fenêtre de terminal
```
mkdir tailstore
cd tailstore
```
Configurer DDEV
Fenêtre de terminal
```
ddev config --project-type=drupal --php-version=8.4 --docroot=web
```
Cette commande crée un fichier .ddev/config.yaml avec :
- Type de projet : Drupal
- Version PHP : 8.4
- Racine web : web/
Démarrer l’environnement
Fenêtre de terminal
```
ddev start
```
DDEV va :
- Télécharger les images Docker nécessaires
- Créer les conteneurs (web, db)
- Configurer le réseau
- Générer les certificats HTTPS
La première fois, le téléchargement des images peut prendre quelques minutes.

Créer le projet Drupal

ddev composer create drupal/recommended-project:^11.0 --no-install
ddev composer install

Vérifier et installer Drush

# Vérifier que Drush est installé
ddev drush --version

# Si Drush n'est pas disponible, l'installer
ddev composer require drush/drush

Installer Drupal

ddev drush site:install standard \
  --site-name="TailStore" \
  --account-name=admin \
  --account-pass=admin \
  --locale=fr \
  -y

Ouvrir le site
Fenêtre de terminal
```
ddev launch
```
Votre navigateur s’ouvre sur https://tailstore.ddev.site

📁 Structure du projet avec DDEV

Après l’installation, votre projet ressemble à :

tailstore/
├── .ddev/
│   ├── config.yaml          # Configuration DDEV
│   ├── docker-compose*.yaml # Configuration Docker
│   └── commands/             # Commandes personnalisées
├── web/                      # Racine web Drupal
│   ├── core/
│   ├── modules/
│   ├── themes/
│   └── sites/
├── vendor/                   # Dépendances PHP
├── composer.json
├── composer.lock
└── .gitignore

⌨️ Commandes DDEV essentielles

Commande	Description
`ddev start`	Démarrer les conteneurs
`ddev stop`	Arrêter les conteneurs
`ddev restart`	Redémarrer
`ddev poweroff`	Arrêter tous les projets DDEV
`ddev describe`	Afficher les infos du projet
`ddev launch`	Ouvrir le site dans le navigateur
`ddev ssh`	Accéder au conteneur web
`ddev composer <cmd>`	Exécuter Composer
`ddev drush <cmd>`	Exécuter Drush
`ddev logs`	Voir les logs
`ddev import-db`	Importer une base de données
`ddev export-db`	Exporter la base de données

🔧 Configuration avancée DDEV

Fichier .ddev/config.yaml

name: tailstore
type: drupal
docroot: web
php_version: "8.4"
webserver_type: nginx-fpm
database:
  type: mariadb
  version: "10.11"

# Hooks personnalisés
hooks:
  post-start:
    - exec: drush cr

Ajouter des services

# Ajouter phpMyAdmin
ddev get ddev/ddev-phpmyadmin

# Ajouter Mailpit (capture des emails)
ddev get ddev/ddev-mailpit

# Redémarrer pour appliquer
ddev restart

Variables d’environnement

Créer .ddev/.env :

# Variables personnalisées
STRIPE_PUBLIC_KEY=pk_test_xxxxx
STRIPE_SECRET_KEY=sk_test_xxxxx

🐛 Résolution de problèmes

Port déjà utilisé

# Changer le port HTTP
ddev config --http-port=8080

# Ou arrêter le service utilisant le port 80
sudo lsof -i :80

Problème de certificat

mkcert -install
ddev restart

Conteneur qui ne démarre pas

# Reconstruire les conteneurs
ddev delete -O
ddev start

Logs pour debug

# Logs du serveur web
ddev logs -f

# Logs spécifiques
ddev logs -s web
ddev logs -s db

✅ Vérification

Votre installation est réussie si :

ddev describe affiche les URLs du projet
ddev launch ouvre votre site Drupal
Vous pouvez vous connecter avec admin/admin
L’interface est en français

🚀 Étape suivante

Passez à l’Installation avec Composer pour comprendre la gestion des dépendances.

Ou si vous préférez XAMPP, consultez Environnement XAMPP.