Configuration et environnement

WP Staging CLI génère automatiquement des fichiers de configuration Docker lors de la création de sites. Ce guide couvre les options de configuration avancées et la génération manuelle de fichiers.

Fichiers de configuration

Lorsque tu crées un site, WP Staging CLI génère ces fichiers dans ~/wpstaging/sites/<hostname>/ :

• docker-compose.yml — configuration principale de Docker Compose
• .env — variables d’environnement
• nginx/ — configuration Nginx et certificats SSL
• php/ — configuration PHP-FPM
• mariadb/ — configuration MariaDB et données

Mettre à jour le fichier hosts

Ajoute ou mets à jour les entrées dans le fichier hosts de ton système pour la résolution des domaines locaux :

wpstaging update-hosts-file

Ou utilise l’alias court :

wpstaging uhf

Cette commande :

• Lit tous les sites configurés
• Ajoute des entrées dans /etc/hosts (Linux/macOS) ou C:\Windows\System32\drivers\etc\hosts (Windows)
• Associe chaque hostname à son adresse IP configurée

Générer le fichier Compose

Régénère le fichier docker-compose.yml pour un site spécifique :

wpstaging generate-compose-file mysite.local

Ou utilise l’alias court :

wpstaging gcf mysite.local

Utilise cette commande lorsque tu as besoin de :

• Réinitialiser le fichier Compose aux valeurs par défaut
• Mettre à jour après des modifications manuelles de configuration
• Résoudre des problèmes Docker

Générer les fichiers Docker

Régénère tous les fichiers de configuration Docker pour un site :

wpstaging generate-docker-file mysite.local

Ou utilise l’alias court :

wpstaging gdf mysite.local

Cela régénère :

• docker-compose.yml
• La configuration Nginx
• La configuration PHP-FPM
• Le fichier d’environnement

Gestion des certificats SSL

WP Staging CLI utilise mkcert pour générer des certificats SSL de confiance locale.

Réinstaller le certificat

En cas de problème de certificat, régénère le certificat SSL pour un site :

wpstaging reinstall-cert mysite.local

Réinstaller l’autorité de certification

Si les certificats ne sont pas approuvés par ton navigateur, réinstalle la CA mkcert dans le magasin de confiance de ton système :

wpstaging reinstall-cert mysite.local --reinstall-ca

Afficher la configuration du site

Affiche les variables d’environnement et la configuration d’un site :

wpstaging compose-info mysite.local

Cela affiche les paramètres du docker-compose.yml analysé, notamment :

• Noms et images des conteneurs
• Correspondances de ports
• Montages de volumes
• Variables d’environnement

Chemin d’environnement personnalisé

Par défaut, tous les environnements Docker sont stockés dans ~/wpstaging. Tu peux spécifier un chemin personnalisé :

wpstaging add mysite.local --env-path=/custom/docker/path

Utilise ensuite le même chemin pour toutes les commandes suivantes :

wpstaging start --env-path=/custom/docker/path
wpstaging list --env-path=/custom/docker/path

Chemin personnalisé du fichier Compose

Spécifie un emplacement personnalisé pour le fichier docker-compose.yml :

wpstaging add mysite.local --compose-file=/custom/path/docker-compose.yml

Configuration des ports

Si les ports par défaut entrent en conflit avec d’autres services, personnalise-les lors de la création des sites :

wpstaging add mysite.local \
  --http-port=8080 \
  --https-port=8443 \
  --db-port=3307 \
  --mailpit-http-port=8026

Configuration de l’adresse IP

Par défaut, les sites utilisent des adresses IP dans la plage 127.3.2.x (adresses de loopback). Cela permet à plusieurs sites de fonctionner simultanément sur les mêmes ports (80/443).

wpstaging add mysite.local --container-ip=127.3.2.5

Alias IP pour macOS

Sur macOS, la CLI crée automatiquement des alias IP pour les adresses dans la plage 127.3.2.x. Cela nécessite un accès sudo.

Récapitulatif des commandes de configuration

Structure des répertoires

La structure par défaut du répertoire d’environnement :

~/wpstaging/
├── sites/
│   └── mysite.local/
│       ├── docker-compose.yml
│       ├── .env
│       ├── www/                    # WordPress files
│       ├── nginx/
│       │   ├── nginx.conf
│       │   └── ssl/
│       │       ├── mysite.local.crt
│       │       └── mysite.local.key
│       ├── php/
│       │   └── php.ini
│       └── mariadb/
│           └── data/               # Database files
└── shared/
    └── mkcert/                     # CA certificates

Prochaines étapes

• Gérer des sites WordPress Docker – Créer et gérer des sites
• Contrôler les conteneurs Docker – Démarrer, arrêter et accéder aux conteneurs