Gérer des sites WordPress Docker

WP Staging CLI peut créer et gérer des environnements WordPress basés sur Docker pour le développement local et les tests. Ce guide explique comment ajouter, lister, supprimer et gérer des sites WordPress.

What You’ll Get

Chaque site Docker inclut :

• PHP-FPM avec la version de PHP choisie
• Serveur web Nginx avec HTTPS
• Base de données MariaDB
• Mailpit pour les tests d’e-mails
• Certificats SSL automatiques via mkcert
• Configuration du fichier hosts pour les domaines locaux

Prérequis

• Docker 20.10.0 ou version ultérieure
• Docker Compose 2.19.0 ou version ultérieure
• Minimum 2 cœurs CPU et 4 Go de RAM

Ajouter un nouveau site

Crée un nouveau site WordPress avec un domaine local personnalisé :

wpstaging add https://mysite.local

Ou sans le protocole :

wpstaging add mysite.local

Tu as besoin d’un WordPress Multisite ?

wpstaging add mysite.local --multisite

Une fois le site créé, tu peux y accéder à l’adresse https://mysite.local.

Ajouter un site depuis un fichier de Backup existant

Crée un nouveau site et restaure-le depuis un fichier de Backup WP Staging en une seule étape :

wpstaging add mysite.local --from=backup.wpstg

Ou depuis une URL distante :

wpstaging add mysite.local --from=https://example.com/backup.wpstg

WordPress Multisite :

wpstaging add mysite.local --multisite --from=BACKUP_URL

Personnaliser la configuration du site

Version de PHP

Spécifie la version de PHP (par défaut : 8.1) :

wpstaging add mysite.local --php=8.2

Les versions de PHP disponibles dépendent des images Docker prises en charge.

Version de WordPress

Installe une version spécifique de WordPress (par défaut : la dernière) :

wpstaging add mysite.local --wp=6.4.2

Ports personnalisés

Change les ports par défaut s’ils entrent en conflit avec d’autres services :

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

Adresse IP du conteneur

Par défaut, les sites utilisent des adresses IP dans la plage 127.3.2.x. Tu peux spécifier une IP personnalisée :

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

Chemin de l’environnement

Change l’emplacement de stockage des environnements Docker (par défaut : ~/wpstaging) :

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

Tous les flags de la commande Add

Flags de configuration WordPress

Lister les sites

Affiche tous les sites WordPress dans ton environnement Docker :

wpstaging list

Exemple de résultat :

HOSTNAME            STATUS      PHP     IP
mysite.local        running     8.1     127.3.2.1
dev.local           stopped     8.2     127.3.2.2
test.local          running     8.0     127.3.2.3

Voir les détails de sites spécifiques

Obtiens des informations détaillées sur un ou plusieurs sites :

wpstaging list mysite.local

Ou plusieurs sites :

wpstaging list site1.local site2.local

Supprimer des sites

Supprime un site spécifique :

wpstaging del mysite.local

Supprime plusieurs sites :

wpstaging del site1.local site2.local

Supprime tous les sites (avec confirmation) :

wpstaging del

Activer/désactiver des sites

Désactive un site sans le supprimer :

wpstaging disable mysite.local

Réactive un site désactivé :

wpstaging enable mysite.local

Les sites désactivés conservent leurs données, mais leurs conteneurs ne sont pas démarrés.

Réinitialiser un site

Réinitialise un site avec une installation WordPress vierge :

wpstaging reset mysite.local

Cela supprime tout le contenu WordPress et réinstalle WordPress tout en conservant la configuration Docker intacte.

Réinitialiser avec une version différente de WordPress

Spécifie une version de WordPress différente lors de la réinitialisation :

wpstaging reset mysite.local --wp=6.5

Réinitialiser et restaurer depuis un Backup

Réinitialise le site et restaure-le depuis un Backup WP Staging en une seule étape :

wpstaging reset mysite.local --from=backup.wpstg
wpstaging reset mysite.local --from=https://example.com/backup.wpstg

Identifiants sécurisés

Pour une meilleure sécurité, notamment dans les environnements partagés, utilise des identifiants aléatoires :

wpstaging add mysite.local --secure-credentials

Cela génère des mots de passe aléatoires pour :

• L’utilisateur root MariaDB
• L’utilisateur de la base de données WordPress
• L’administrateur WordPress

Les identifiants générés s’affichent après la création du site.

WordPress Multisite

Crée une installation WordPress Multisite :

wpstaging add mynetwork.local --multisite

Notes pour macOS

Prochaines étapes

• Contrôler les conteneurs Docker – Démarrer, arrêter et gérer les conteneurs
• Configuration Docker – Options de configuration avancées
• Créer une copie locale d’un site WordPress – Tutoriel complet