Gérer un site WordPress en ligne de commande peut transformer radicalement votre quotidien de développeur ou d’administrateur système. Finies les manipulations longues et répétitives dans l’interface graphique : avec WP-CLI (WordPress Command Line Interface), vous disposez d’un outil rapide, puissant et scriptable pour intervenir directement sur une installation WordPress. Du simple ajout d’un utilisateur à l’automatisation du déploiement complet d’un site, les commandes WP-CLI couvrent une grande variété de cas d’usage. Cet article vous propose un tour d’horizon des commandes les plus utiles, accompagnées d’explications concrètes pour les intégrer dans votre flux de travail quotidien.

Comprendre la structure et l’usage des commandes WP-CLI

WP-CLI est un projet open source dont les premières bases ont été posées en 2011 par l’ingénieur australien Daniel Bachhuber, qui travaillait alors pour Automattic. L’objectif initial était simple mais ambitieux : offrir une alternative rapide, fiable et scriptable à l’interface d’administration graphique de WordPress. Le projet a rapidement gagné en popularité auprès des développeurs, notamment ceux gérant de nombreux sites ou travaillant dans des contextes de déploiement automatisé. En 2015, WP-CLI a officiellement rejoint l’écosystème WordPress via le programme « WordPress.org Open Source » et est depuis maintenu par une équipe de contributeurs actifs. Il est aujourd’hui reconnu comme l’un des outils techniques les plus puissants autour de WordPress, utilisé aussi bien par des freelances que par de grandes agences et entreprises SaaS.

Depuis la sortie de la version 1.0.0 en janvier 2017, WP-CLI a vu son architecture se stabiliser. Chaque commande suit une structure logique basée sur une hiérarchie de sous-commandes, ce qui rend son usage cohérent et prévisible. Par exemple, la commande :

wp plugin install

permet d’installer un plugin depuis le dépôt officiel, tandis que :

wp plugin activate

active ce plugin sur votre site. Ce fonctionnement modulaire est fondé sur un système de verbes d’action (install, activate, delete, list, etc.) appliqués à des entités clés de WordPress (plugin, theme, user, post, etc.). Cette approche permet une lecture intuitive des commandes, même pour les débutants en ligne de commande. Avant d’exécuter des actions plus complexes, il est recommandé de vérifier que WP-CLI est correctement installé et opérationnel sur votre système. Pour cela, la commande suivante vous donnera un aperçu de la configuration actuelle :

wp --info

Cette commande affiche des informations utiles : version de WP-CLI installée, version de PHP, configuration système, chemin vers le fichier wp-config, et même l’environnement d’exécution (Docker, local, distant…). C’est une bonne pratique de la lancer pour diagnostiquer rapidement un problème ou valider un environnement avant déploiement.

Pour naviguer dans l’écosystème des commandes disponibles, WP-CLI propose un système d’aide intégré très complet. En tapant :

wp help

vous obtenez la liste de toutes les commandes de base disponibles. Vous pouvez aussi demander de l’aide pour un module en particulier. Par exemple :

wp help plugin

vous affichera la documentation des sous-commandes liées à la gestion des extensions, comme install, delete, update ou status. Cette documentation est souvent plus rapide à consulter que les pages officielles du Codex, surtout en environnement serveur ou via SSH.

Avec le temps, WP-CLI est devenu bien plus qu’un simple utilitaire de ligne de commande. À partir de la version 2.0.0 (août 2018), l’outil a été restructuré pour adopter une architecture de paquets extensibles, permettant aux développeurs de créer leurs propres commandes personnalisées ou d’utiliser des packages tiers. Cette évolution a fait de WP-CLI une véritable plateforme d’automatisation et de DevOps autour de WordPress. Aujourd’hui, WP-CLI en est à version 2.12.0, avec des mises à jour régulières intégrant à la fois des corrections de compatibilité, des améliorations de performance et des ajouts de commandes liées aux évolutions du cœur WordPress. Il est compatible avec la majorité des environnements (Linux, macOS, Windows via WSL) et peut être exécuté localement, sur des serveurs distants, dans des conteneurs Docker ou des pipelines CI/CD comme GitLab CI ou GitHub Actions.

Installer, mettre à jour et personnaliser WP-CLI dans son terminal

Avant de commencer à utiliser WP-CLI, il est important de s’assurer que votre environnement est compatible. Cet outil fonctionne de manière optimale sur des systèmes Unix-like tels que Linux, macOS ou FreeBSD. Bien que certains utilisateurs parviennent à l’utiliser sous Windows via WSL ou Cygwin, l’environnement n’y est pas officiellement supporté de manière complète. Côté logiciel, WP-CLI nécessite au minimum la version 5.6 de PHP, ainsi qu’une installation de WordPress en version 3.7 ou plus récente. Une fois ces prérequis confirmés, l’installation peut se faire de façon très simple à l’aide du binaire phar, qui représente la méthode recommandée par les mainteneurs du projet.

Commencez par télécharger le fichier exécutable avec une commande curl ou wget :

curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar

Vous pouvez ensuite vérifier que WP-CLI est opérationnel en exécutant :

php wp-cli.phar --info

Pour utiliser WP-CLI plus confortablement via la commande wp directement dans votre terminal, il est conseillé de rendre le fichier exécutable et de le déplacer dans un répertoire inclus dans votre PATH, comme suit :

chmod +x wp-cli.phar
sudo mv wp-cli.phar /usr/local/bin/wp

Une fois cette étape complétée, vous pouvez tester la commande :

wp --info

Si tout fonctionne, WP-CLI vous retournera des informations détaillées sur votre environnement système, y compris la version de PHP utilisée, les chemins vers vos fichiers de configuration, la version de WP-CLI et plus encore.

Mise à jour de WP-CLI

WP-CLI peut être mis à jour manuellement, soit en réimportant le fichier .phar comme lors de l’installation initiale, soit en utilisant sa propre commande de mise à jour :

wp cli update

Pour les utilisateurs qui souhaitent toujours disposer des dernières fonctionnalités, il est possible d’installer la version “nightly” (build quotidien instable mais utilisable en développement) avec l’option suivante :

wp cli update --nightly

Ce mode de mise à jour est particulièrement utile pour tester les nouvelles fonctionnalités avant leur intégration dans une version stable, ou pour contribuer au projet.

Activer l’autocomplétion pour Bash ou ZSH

Pour aller plus loin dans l’usage de WP-CLI, vous pouvez activer l’autocomplétion des commandes dans votre terminal. Cela vous permet de taper plus vite, avec moins d’erreurs, et de découvrir plus facilement les sous-commandes disponibles.

Commencez par télécharger le fichier d’autocomplétion pour Bash :

curl -O https://raw.githubusercontent.com/wp-cli/wp-cli/master/utils/wp-completion.bash

Ensuite, ajoutez ce fichier à votre environnement Bash via le fichier ~/.bash_profile ou ~/.bashrc :

source /chemin/vers/wp-completion.bash

Si vous utilisez ZSH, quelques étapes supplémentaires sont nécessaires. Il faudra activer la compatibilité avec Bash via les commandes suivantes dans votre fichier .zshrc :

autoload bashcompinit
bashcompinit
source /chemin/vers/wp-completion.bash

Une fois ces lignes ajoutées, redémarrez votre terminal ou rechargez votre profil pour profiter de l’autocomplétion WP-CLI dans vos prochaines sessions. Cette fonctionnalité devient vite indispensable dès lors que vous utilisez régulièrement WP-CLI pour la gestion avancée de WordPress.

La liste des commandes WP-CLI pour les développeurs WordPress

WP-CLI propose une collection impressionnante de commandes pour automatiser la gestion d’un site WordPress. Que vous soyez développeur, intégrateur ou administrateur système, cet outil vous permet d’interagir avec votre installation WordPress sans jamais ouvrir votre navigateur. Voici une sélection détaillée des commandes disponibles, classées par type d’usage, pour améliorer vos workflows quotidiens.

La gestion du cœur de WordPress avec WP-CLI

La commande wp core est l’un des piliers de WP-CLI. Elle regroupe toutes les actions liées à l’installation, la mise à jour, la réinstallation et la gestion de la version de WordPress. Que vous déployiez un nouveau site ou que vous souhaitiez automatiser une mise à jour sur plusieurs projets, ces commandes offrent un contrôle précis, rapide et fiable sur le cœur du CMS.

Voici un tableau récapitulatif des principales sous-commandes wp core et de leur utilité concrète :

Commande	Description
wp core download	Télécharge la dernière version de WordPress dans le dossier courant. Vous pouvez ajouter l’option --locale=fr_FR pour télécharger directement la version en français.
wp core install	Installe WordPress avec les paramètres de base (URL, titre, admin, mot de passe). Idéal pour automatiser une installation en local ou sur un serveur distant.
wp core update	Met à jour WordPress vers la dernière version stable disponible. Indispensable pour maintenir un site sécurisé et à jour.
wp core update --version=6.4.3	Met à jour vers une version spécifique, utile en cas de rétrocompatibilité à respecter ou pour tester une version donnée.
wp core update --minor	Effectue uniquement les mises à jour mineures (par exemple de 6.4.1 à 6.4.2), souvent utilisées sur des environnements sensibles.
wp core verify-checksums	Vérifie l’intégrité des fichiers WordPress installés en les comparant aux versions officielles. Très utile pour détecter des modifications suspectes ou des fichiers corrompus.
wp core check-update	Affiche les versions disponibles pour la mise à jour de WordPress. Cette commande est souvent utilisée dans des scripts d’audit automatisés.
wp core version	Retourne la version actuelle de WordPress installée. Simple, rapide et efficace pour valider une configuration.
wp core is-installed	Vérifie si WordPress est déjà installé dans le répertoire courant. Très utile pour conditionner l’exécution de scripts automatisés.
wp core install-network	Configure l’installation actuelle pour fonctionner en multisite. Cette commande facilite la mise en place d’un réseau de sites depuis la ligne de commande.

Grâce à ce jeu de commandes, il est possible de déployer un site WordPress complet, en quelques secondes, sans toucher une seule fois à l’interface graphique. L’usage de wp core s’intègre parfaitement dans des workflows DevOps, des scripts de déploiement continu, ou des environnements Dockerisés. Couplée à des outils comme wp config et wp db, cette commande devient le socle d’une gestion professionnelle de vos projets WordPress.

La configuration initiale de WordPress avec WP-CLI

Le fichier wp-config.php est le cœur de la configuration technique de WordPress. Grâce à la commande wp config, vous pouvez générer ce fichier ou le modifier dynamiquement sans avoir à l’ouvrir manuellement. Cette approche évite les erreurs de syntaxe, accélère les déploiements et s’intègre facilement dans des scripts automatisés. Que vous souhaitiez activer le mode debug, ajouter une clé de sécurité, ou définir un paramètre personnalisé, WP-CLI offre un contrôle total sur ce fichier fondamental.

Voici un tableau récapitulatif des commandes wp config les plus utiles pour configurer et personnaliser votre WordPress.

Commande	Description
wp config create	Génère un fichier wp-config.php à partir des paramètres passés en ligne de commande (base de données, hôte, utilisateur, mot de passe, etc.). Parfait pour une installation automatisée.
wp config set WP_DEBUG true --raw	Active le mode debug pour faciliter le développement et la détection des erreurs PHP. L’option --raw permet d’éviter que la valeur ne soit interprétée comme une chaîne de caractères.
wp config set WP_MEMORY_LIMIT 256M	Augmente la mémoire PHP disponible pour WordPress. Indispensable pour des sites gourmands ou en environnement de développement intensif.
wp config set FS_METHOD direct	Force WordPress à utiliser le système de fichiers directement (sans FTP). Utile en environnement local ou Docker où le FTP est absent.
wp config set WP_ENV production	Ajoute une constante personnalisée (par exemple WP_ENV) pour définir l’environnement (développement, staging, production).
wp config delete WP_DEBUG	Supprime une constante du fichier de configuration. Pratique pour nettoyer ou réinitialiser un projet.
wp config get WP_HOME	Récupère la valeur actuelle d’une constante définie dans le wp-config.php. Permet de vérifier la configuration sans ouvrir le fichier.
wp config list	Liste toutes les constantes actuellement définies dans le fichier wp-config.php, y compris celles personnalisées par l’utilisateur ou les scripts.
wp config path	Affiche le chemin absolu vers le fichier wp-config.php utilisé. Utile sur les systèmes complexes avec plusieurs environnements ou fichiers de config secondaires.

Avec ces commandes, vous pouvez non seulement automatiser la création du fichier de configuration, mais aussi le manipuler dynamiquement selon les besoins de votre projet. Cela ouvre la porte à une gestion plus propre, reproductible et versionnable de vos installations WordPress. Dans un contexte de CI/CD, cette granularité est précieuse pour déployer rapidement des environnements adaptés sans intervention manuelle.

Gérer la base de données de WordPress avec WP-CLI

La gestion de la base de données (qui peut se faire aussi par le tableau de bord via un plugin) est un aspect fondamental de tout projet WordPress, que ce soit pour effectuer des sauvegardes, optimiser les performances ou réaliser des opérations en masse. Grâce à la commande wp db, il est possible d’interagir directement avec la base MySQL ou MariaDB définie dans le fichier wp-config.php. Cette commande s’avère particulièrement utile en phase de développement, de migration ou de maintenance.

Voici un tableau des sous-commandes wp db les plus utilisées pour gérer efficacement la base de données de votre site WordPress.

Commande	Description
wp db export backup.sql	Exporte toute la base de données dans un fichier SQL. Ce fichier peut ensuite être versionné, stocké ou utilisé pour une migration. Vous pouvez également spécifier un chemin complet ou un répertoire.
wp db import backup.sql	Importe un fichier SQL dans la base de données actuelle. Très utile pour restaurer une sauvegarde ou copier une base d’un environnement à un autre.
wp db optimize	Optimise toutes les tables de la base de données. Cela permet de libérer de l’espace et d’améliorer les performances en supprimant les enregistrements inutilisés ou fragmentés.
wp db repair	Répare les tables corrompues de la base de données. Cette commande peut résoudre certains problèmes de performances ou d’erreurs SQL sans avoir à accéder à phpMyAdmin.
wp db reset	Efface complètement la base de données (toutes les tables) et les recrée. Idéal pour repartir de zéro lors d’un développement local ou pour automatiser des tests.
wp db check	Vérifie l’intégrité des tables de la base de données. Une commande utile dans les scripts de maintenance régulière.
wp db query "SELECT COUNT(*) FROM wp_posts;"	Exécute une requête SQL personnalisée. Permet de réaliser des analyses rapides sans accéder à un client MySQL ou une interface graphique.
wp db tables	Liste les tables présentes dans la base de données WordPress. Cette commande est utile pour auditer une installation ou vérifier la cohérence après une migration.
wp db size --tables	Affiche la taille de chaque table de la base. Pratique pour identifier les tables les plus volumineuses ou problématiques.
wp db cli	Ouvre un terminal interactif MySQL avec les identifiants déjà préconfigurés. Cela permet de se connecter sans taper le mot de passe ou les informations de connexion.

De fait, et c’est très pratique d’un point de vue sécuritaire, vous pouvez automatiser vos sauvegardes, nettoyer régulièrement votre base de données, diagnostiquer des anomalies, ou encore mettre en place des environnements de test reproductibles. WP-CLI vous libère ainsi de la dépendance à des outils tiers comme phpMyAdmin ou Adminer, tout en garantissant rapidité, fiabilité et sécurité des opérations critiques.

Gérer avec WP-CLI les utilisateurs, rôles et permissions dans WordPress

WP-CLI permet une gestion fine des utilisateurs WordPress, que ce soit pour les créer, les modifier, les supprimer ou leur attribuer des rôles spécifiques. Cela se révèle particulièrement pratique lors du déploiement d’environnements de test, de la création automatisée de comptes pour des contributeurs ou encore pour gérer les droits à grande échelle dans une installation multisite. Les commandes wp user, wp role et wp cap couvrent l’ensemble des fonctionnalités nécessaires à cette gestion. Voici un tableau des principales commandes à connaître :

Commande	Description
wp user create alice alice@example.com --role=editor	Crée un utilisateur avec un rôle défini. WP-CLI génère un mot de passe automatiquement (affiché dans le terminal).
wp user list	Affiche la liste des utilisateurs existants avec leur ID, nom d’utilisateur, e-mail et rôle. Vous pouvez filtrer les résultats avec --role=editor par exemple.
wp user update 15 --role=administrator	Modifie le rôle de l’utilisateur ayant l’ID 15. Utile pour promouvoir ou rétrograder un compte.
wp user delete 23 --reassign=1	Supprime l’utilisateur avec l’ID 23 et réattribue ses contenus à l’utilisateur 1. Évite de perdre des articles ou des pages lors de la suppression.
wp user meta get 10 first_name	Récupère une donnée utilisateur spécifique dans les métas (ici, le prénom). Pratique pour les audits ou les exports de données.
wp user meta update 10 nickname "Al"	Met à jour une métadonnée pour un utilisateur. Utile pour la personnalisation ou la synchronisation inter-sites.
wp role create redacteur "Rédacteur personnalisé"	Crée un nouveau rôle avec un nom lisible. Idéal pour définir des rôles métiers spécifiques à votre projet.
wp role delete redacteur	Supprime un rôle personnalisé précédemment créé. À utiliser avec précaution pour éviter les erreurs de permissions.
wp cap add redacteur publish_pages	Ajoute une capacité à un rôle. Dans cet exemple, les utilisateurs avec le rôle redacteur peuvent publier des pages.
wp cap remove redacteur delete_posts	Retire une capacité d’un rôle. Permet un contrôle précis des permissions attribuées aux profils utilisateurs.
wp super-admin add alice	Ajoute un utilisateur comme super admin sur un réseau multisite. Cette commande ne fonctionne que si WP est en mode multisite.
wp super-admin remove alice	Retire le statut de super administrateur à un utilisateur. Attention, les super admins ont accès à tous les sites du réseau.

Ainsi, vous pouvez automatiser l’ensemble des opérations liées à la gestion des utilisateurs dans WordPress. Que ce soit pour un site simple ou un réseau multisite complexe, WP-CLI vous offre une rapidité d’exécution incomparable, tout en évitant les erreurs de clic ou les oublis de configuration manuelle.

Gérer les plugins et thèmes de WordPress avec WP-CLI

La gestion des extensions (plugins) et des thèmes avec WP-CLI permet de gagner un temps considérable, notamment lorsqu’il s’agit de maintenir plusieurs sites, de déployer une configuration standard ou de faire du développement local. Fini les interfaces lentes et les clics répétés : tout se fait en ligne de commande avec rapidité et précision. Les commandes wp plugin et wp theme permettent d’installer, d’activer, de désactiver, de supprimer ou encore de mettre à jour vos composants WordPress en quelques secondes. Voici les principales commandes à connaître :

Commande	Description
wp plugin install woocommerce --activate	Installe le plugin WooCommerce depuis le dépôt officiel et l’active immédiatement. Idéal pour automatiser l’installation d’un socle e-commerce.
wp plugin install akismet --activate --version=5.3	Installe une version spécifique d’un plugin. Pratique pour maintenir la compatibilité avec un projet existant.
wp plugin update --all	Met à jour tous les plugins installés. Indispensable dans les tâches de maintenance régulière ou dans un script de déploiement CI/CD.
wp plugin list	Affiche tous les plugins installés avec leur statut (activé ou non), leur version, et si une mise à jour est disponible.
wp plugin activate contact-form-7	Active un plugin déjà installé. Peut être utilisé après une migration ou un clonage de site.
wp plugin deactivate contact-form-7	Désactive un plugin sans le supprimer. Utile pour diagnostiquer un conflit ou effectuer des tests sans désinstaller.
wp plugin delete hello	Supprime un plugin du site (et du système de fichiers). Parfait pour faire le ménage dans une installation allégée.
wp theme install twentytwentyfour --activate	Installe et active le thème Twenty Twenty-Four. Pratique pour définir rapidement un thème de base dans un nouveau projet.
wp theme list	Affiche tous les thèmes installés, leur statut (actif ou non) et leur version. Permet une vue rapide sur l’état des thèmes dans un projet.
wp theme activate astra	Active le thème Astra s’il est déjà installé. Cette commande est utile lors de la préparation d’un site client ou d’un environnement de démonstration.
wp theme update --all	Met à jour tous les thèmes installés. À intégrer dans des tâches de mise à jour récurrente.
wp theme delete twentyseventeen	Supprime le thème Twenty Seventeen du système. Cela permet de réduire le nombre de fichiers inutiles dans un projet de production.

En combinant ces commandes, vous pouvez bâtir des scripts complets de configuration WordPress, gagner du temps sur la gestion des projets clients, et améliorer la sécurité en maintenant à jour vos extensions et thèmes. Dans un environnement d’agence ou de production, ces opérations peuvent être intégrées à des pipelines d’intégration continue ou à des tâches cron automatisées pour garder vos installations toujours optimales.

La gestion du contenu avec WP-CLI : articles, pages, médias

Avec WP-CLI, il est possible de créer, modifier, publier ou supprimer du contenu sans passer par l’interface d’administration. Que ce soit pour créer un article, importer une image ou modérer un commentaire, ces opérations peuvent être exécutées rapidement, de façon scriptée et reproductible. C’est un gain de temps précieux, notamment pour les agences, les développeurs d’outils de migration ou les administrateurs techniques. Voici un tableau récapitulatif des principales commandes WP-CLI pour gérer les articles, les pages, les médias et les commentaires.

Commande	Description
wp post create --post_type=post --post_title="Nouvel article" --post_status=publish	Crée un nouvel article publié immédiatement. Vous pouvez également spécifier le contenu, l’auteur, la date de publication ou une catégorie.
wp post create --post_type=page --post_title="Mentions légales" --post_status=publish	Crée une page statique publiée, utile lors de l’automatisation de la structure d’un site (mentions, politique de confidentialité, etc.).
wp post list --post_type=post	Liste tous les articles du site avec leurs ID, titres, statuts et dates. Idéal pour les audits ou les exports.
wp post delete 123	Supprime définitivement un article ou une page via son ID. À utiliser avec précaution.
wp media import mon-image.jpg --title="Logo" --alt="Logo du site"	Ajoute un fichier image dans la médiathèque et définit automatiquement son titre et son texte alternatif (utile pour le SEO et l’accessibilité).
wp media regenerate	Régénère les miniatures de toutes les images. Recommandé après un changement de thème ou de taille d’image dans les réglages.
wp media list	Affiche la liste des fichiers dans la médiathèque avec leurs ID, URL, titres et types MIME. Permet de localiser rapidement un fichier spécifique.
wp comment list	Liste les commentaires du site avec leur statut (approuvé, en attente, spam). Peut être filtré par post, auteur ou date.
wp comment approve 25	Approuve le commentaire ayant l’ID 25. Utile pour modérer des commentaires en masse depuis un script ou une interface personnalisée.
wp comment delete 42	Supprime définitivement un commentaire. Peut aussi être utilisé pour nettoyer automatiquement les spams ou les commentaires en attente.
wp comment status 25 spam	Marque le commentaire 25 comme spam. Pratique pour automatiser le traitement de contenus indésirables.

WP-CLI vous permet de gérer tout le cycle de vie du contenu, depuis la création d’un article ou d’une page, jusqu’à la gestion des commentaires et des médias. Cela s’intègre parfaitement dans des scripts de génération de contenu, des outils de migration ou des interfaces d’administration personnalisées.

Gérer la navigation et les menus de WP

Les menus de navigation jouent un rôle central dans l’ergonomie d’un site WordPress. Grâce à la commande wp menu, vous pouvez créer, modifier, assigner ou supprimer des menus sans passer par l’interface d’administration. Cela est particulièrement utile lors du déploiement d’un thème personnalisé, dans un environnement multisite, ou pour automatiser la configuration d’un site client.

Voici un tableau récapitulatif des principales commandes disponibles pour gérer les menus avec WP-CLI :

Commande	Description
wp menu create "principal"	Crée un nouveau menu de navigation nommé « principal ». Cette étape est nécessaire avant d’y ajouter des éléments.
wp menu list	Affiche la liste des menus existants sur le site, avec leur slug, nom, ID, et emplacement s’ils sont déjà assignés.
wp menu delete principal	Supprime complètement un menu existant. Utile pour repartir d’une structure propre ou réinitialiser une configuration.
wp menu item add-post principal 123	Ajoute l’article ayant l’ID 123 au menu « principal ». La commande détecte automatiquement le titre de l’article et génère le lien.
wp menu item add-page principal 45	Ajoute une page existante au menu. Très utile pour préconfigurer des menus standards comme « Accueil », « Contact » ou « Mentions légales ».
wp menu item add-custom principal "Blog" https://monsite.com/blog	Ajoute un lien personnalisé au menu avec un libellé (« Blog ») et une URL. Parfait pour les liens externes ou les ancres spécifiques.
wp menu item list principal	Affiche tous les éléments du menu « principal », avec leur ID, ordre et type (page, article, lien personnalisé, etc.).
wp menu item delete 87	Supprime un élément spécifique d’un menu à l’aide de son ID. À utiliser pour nettoyer ou reconfigurer la navigation.
wp menu location assign principal primary	Assigne le menu « principal » à l’emplacement primary défini par le thème actif. Cela le rend visible sur le site sans intervention manuelle.
wp menu location list	Affiche tous les emplacements de menu disponibles selon le thème actuel (par exemple : primary, footer, etc.).
wp menu location remove primary	Désassocie tout menu de l’emplacement primary. Cela peut servir à désactiver la navigation principale temporairement.

en pratique, il devient facile d’automatiser la configuration des menus dans un projet WordPress, que ce soit dans un processus de déploiement continu, une installation multisite ou un thème personnalisé. WP-CLI permet ainsi de rendre les menus dynamiques, structurés et conformes aux exigences UX dès la première mise en ligne.

La gestion des traductions et langues avec WP-CLI

Que vous développiez un site multilingue ou un thème destiné à l’international, la gestion des langues et des fichiers de traduction est un point central. WP-CLI permet non seulement d’installer et d’activer des packs de langue, mais aussi de générer des fichiers .pot pour vos plugins ou thèmes grâce aux commandes wp i18n. Voici un tableau des principales commandes liées aux langues et à l’internationalisation (i18n) dans WordPress via WP-CLI :

Commande	Description
wp language core install fr_FR --activate	Télécharge et active le pack de langue français pour l’interface d’administration WordPress. Peut être utilisé avec n’importe quelle locale supportée (ex : es_ES, de_DE, etc.).
wp language core list	Liste tous les packs de langue disponibles, installés ou non. Affiche aussi leur statut et version. Très utile pour auditer une installation multilingue.
wp language core activate en_US	Bascule WordPress vers l’anglais (US). Cette commande est souvent utilisée dans des environnements de développement internationaux ou pour revenir à la langue par défaut.
wp language plugin install woocommerce fr_FR	Installe le fichier de traduction français pour un plugin donné (ici WooCommerce). Permet de localiser les extensions automatiquement.
wp language theme install astra fr_FR	Installe la traduction française pour un thème spécifique. Cela évite de devoir copier les fichiers manuellement dans le dossier /languages.
wp i18n make-pot ./mon-plugin ./languages/mon-plugin.pot	Génère un fichier .pot contenant toutes les chaînes de traduction de votre plugin personnalisé. Cette commande est essentielle pour rendre un plugin ou un thème traduisible.
wp i18n make-json ./languages/	Transforme les fichiers .po en fichiers json compatibles avec les blocs Gutenberg. Utile si vous développez des blocs avec des chaînes traduisibles.
wp i18n validate ./mon-theme	Vérifie les bonnes pratiques i18n dans le code source d’un plugin ou thème. Cela aide à repérer les chaînes non échappées ou non localisées.

La gestion multilingue devient plus simple, plus fiable et surtout bien plus rapide que par l’administration classique. C’est un outil incontournable pour tout développeur WordPress qui vise la compatibilité internationale ou qui souhaite optimiser le processus de localisation de ses projets.

La maintenance et le cache de WordPress : WP-CLI devient bien pratique

Les opérations de maintenance et de nettoyage sont essentielles pour garantir la stabilité et les performances d’un site WordPress. WP-CLI permet d’automatiser ces tâches avec des commandes simples mais puissantes. Que ce soit pour activer un mode maintenance temporaire, vider les caches ou supprimer les transients, tout peut être scripté et intégré dans vos workflows d’administration.

Commande	Description
wp maintenance-mode activate	Active le mode maintenance, utile lors d’une mise à jour, d’une migration ou de toute opération critique. Affiche une page de maintenance aux visiteurs non connectés.
wp maintenance-mode deactivate	Désactive le mode maintenance et remet le site en ligne. À exécuter une fois les opérations sensibles terminées.
wp cache flush	Vide complètement le cache objet (Object Cache). Cette commande est souvent utilisée après des modifications profondes dans la base ou la structure du site.
wp transient delete --all	Supprime tous les transients (valeurs temporaires stockées dans la base de données). Cela permet d’alléger la base et d’éviter les valeurs périmées.
wp transient list	Affiche la liste des transients actuellement actifs. Permet d’auditer ce qui est stocké temporairement dans le système.

Réglages, options et personnalisations gérés avec WP-CLI

WordPress stocke une multitude de réglages dans sa table wp_options : titre du site, description, URL, réglages d’extensions, etc. WP-CLI permet de consulter, modifier ou supprimer ces options facilement, sans passer par l’interface d’administration ou phpMyAdmin.

Commande	Description
wp option get blogname	Récupère le titre du site. Idéal pour vérifier dynamiquement la configuration d’un site ou générer un rapport d’audit.
wp option update blogdescription "Un site propulsé par WP-CLI"	Met à jour le slogan (description) du site. Peut aussi s’appliquer à n’importe quelle autre option personnalisée.
wp option list	Liste toutes les options enregistrées dans la base. Cette commande est utile pour explorer la configuration complète du site.
wp option delete home	Supprime une option spécifique. Attention : la suppression d’options critiques peut provoquer des erreurs de chargement.
wp option patch update active_plugins 0 akismet/akismet.php	Modifie une valeur complexe (sérialisée) dans une option. Très utile pour manipuler des tableaux d’options sans les réécrire manuellement.

Le routage et les permaliens de WordPress avec WP-CLI

Les permaliens jouent un rôle essentiel dans la structuration des URLs d’un site WordPress. Ils ont un impact direct sur le référencement naturel (SEO), l’accessibilité et l’expérience utilisateur. Le format d’URL propre nomdedomaine.fr/category/postname est largement préféré pour sa clarté et sa capacité à inclure des mots-clés pertinents, ce qui favorise l’indexation par les moteurs de recherche. Avec WP-CLI, il est possible de gérer, modifier et réinitialiser les règles de réécriture et les structures de permaliens sans passer par l’administration graphique. Cela s’avère particulièrement utile après l’ajout de types de contenus personnalisés (CPT), de taxonomies ou lors de la migration d’un site.

Voici les principales commandes à connaître pour gérer les permaliens via WP-CLI :

Commande	Description
wp rewrite structure '/%category%/%postname%/' --hard	Définit la structure des permaliens au format /catégorie/nom-de-l-article/. Ce format est optimal pour le SEO et la hiérarchie logique du contenu.
wp rewrite flush	Réinitialise les règles de réécriture. À exécuter systématiquement après un changement de structure de permaliens ou l’ajout d’un nouveau type de contenu personnalisé.
wp rewrite list	Affiche toutes les règles de réécriture actuellement en vigueur. Très utile pour diagnostiquer un problème de routage ou de lien rompu.
wp rewrite delete category	Supprime une règle de réécriture spécifique. À utiliser avec précaution, surtout dans des environnements multisites ou multilingues.
wp option get permalink_structure	Affiche la structure actuelle des permaliens. Permet de vérifier rapidement si le format souhaité est bien en place.
wp option update permalink_structure '/%postname%/'	Modifie directement la structure des permaliens via la base de données. Peut être combiné avec un wp rewrite flush pour appliquer immédiatement les changements.
wp rewrite structure '/%year%/%monthnum%/%postname%/'	Utilise une structure de type date, pratique pour les blogs à contenu éditorial très fréquent. Moins SEO-friendly que la structure /category/postname, mais parfois nécessaire.

La gestion des permaliens via WP-CLI s’avère particulièrement utile dans les environnements de staging ou dans les déploiements automatisés où l’on veut appliquer la même structure d’URL sur plusieurs instances sans passer par l’administration web. C’est aussi un moyen fiable de restaurer un routage fonctionnel après l’importation d’un site, la restauration d’une base ou un changement de domaine.

L’automatisation via WP-Cron

WordPress intègre nativement un système de tâches planifiées appelé WP-Cron. Celui-ci permet d’exécuter automatiquement des actions à intervalles réguliers, comme la publication différée d’un article, la vérification des mises à jour, ou le nettoyage des transients expirés. Cependant, WP-Cron ne fonctionne que lorsqu’un visiteur charge une page, ce qui limite sa fiabilité sur des sites à faible trafic. Avec WP-CLI, vous avez la possibilité de contrôler entièrement ces événements cron : les exécuter manuellement, les lister, les supprimer ou même les simuler. Cela vous permet de fiabiliser vos automatisations, surtout dans les contextes où WP-Cron est désactivé au profit d’un vrai cron système (Unix/Linux).

Voici les principales commandes pour gérer WP-Cron via WP-CLI :

Commande	Description
wp cron event list	Affiche la liste complète des événements cron planifiés : leur nom, récurrence, heure d’exécution prévue et hook associé. Indispensable pour auditer le fonctionnement du site.
wp cron event run wp_scheduled_delete	Exécute manuellement une tâche programmée. Ici, wp_scheduled_delete permet de nettoyer les anciens révisions et transients. Idéal pour les tests ou le dépannage.
wp cron event run --due-now	Exécute tous les événements censés être lancés « maintenant ». Cette commande est souvent intégrée dans des scripts de cron système pour compenser l’absence de trafic utilisateur.
wp cron event delete wp_update_plugins	Supprime une tâche cron spécifique. À utiliser pour désactiver une tâche inutile ou problématique, comme la vérification automatique des extensions.
wp cron schedule list	Liste tous les intervalles de planification disponibles (hourly, twice_daily, daily, etc.), et leurs valeurs en secondes. Utile pour vérifier les fréquences disponibles dans le système.
wp cron event schedule my_custom_event --time=now +5minutes --hook=my_hook	Planifie manuellement une tâche personnalisée avec un hook défini. Utile dans un plugin ou pour des traitements temporisés sur mesure.

Pour les développeurs et administrateurs système, ces commandes offrent une alternative professionnelle et contrôlable au comportement parfois imprévisible de WP-Cron natif. En les combinant à un vrai cron Unix (crontab), vous pouvez déclencher vos événements de façon fiable, même en l’absence de visiteurs :

*/5 * * * * cd /chemin/vers/votre/site && wp cron event run --due-now > /dev/null 2>&1

Ce type de configuration garantit que vos tâches planifiées (vérification de mails, traitements de commandes WooCommerce, nettoyage des révisions, etc.) s’exécutent toujours à l’heure, et sans dépendre du trafic réel du site. En résumé, WP-CLI + WP-Cron = une automatisation puissante, maîtrisée et professionnelle.

Scaffolding et génération de code

Le terme scaffolding vient du mot anglais “scaffold” qui signifie “échafaudage”. En développement, il désigne la génération automatique de fichiers et de structures de base pour démarrer un projet. WP-CLI propose une série de commandes wp scaffold qui permettent de créer rapidement l’ossature d’un plugin, d’un thème ou d’un composant WordPress (type de contenu, taxonomie, bloc, etc.), tout en respectant les bonnes pratiques de développement WordPress. Cette approche est particulièrement utile pour les développeurs souhaitant gagner du temps, démarrer un projet propre ou produire un prototype fonctionnel sans repartir de zéro.

Voici un tableau récapitulatif des principales commandes disponibles avec wp scaffold :

Commande	Description
wp scaffold plugin mon-plugin	Crée la structure complète d’un plugin avec fichier principal, en-tête, readme.txt, hooks de base, internationalisation, etc. C’est le point de départ idéal pour créer un plugin sur mesure.
wp scaffold theme mon-theme	Génère un thème WordPress minimaliste avec fichiers essentiels : style.css, functions.php, index.php, et un en-tête déclaratif conforme aux standards WordPress.
wp scaffold child-theme mon-theme-child --parent_theme=twentytwentyfour	Crée un thème enfant prêt à l’emploi, basé sur un thème parent spécifié. Pratique pour personnaliser un thème sans en modifier les fichiers originaux.
wp scaffold post-type produit	Génère le code PHP pour enregistrer un custom post type nommé « produit », avec labels, icône, prise en charge des taxonomies, et arguments configurables.
wp scaffold taxonomy marque --post_types=produit	Génère une taxonomie personnalisée (ici “marque”) et l’associe au post type “produit”. Permet de structurer le contenu de manière plus fine.
wp scaffold plugin-tests mon-plugin	Crée l’architecture nécessaire aux tests unitaires d’un plugin avec PHPUnit. Favorise le développement orienté test (TDD) dans l’écosystème WordPress.
wp scaffold block mon-bloc	Génère le squelette d’un bloc Gutenberg avec son script JavaScript, fichier block.json et styles CSS/SCSS. Idéal pour commencer rapidement un développement moderne avec React.
wp scaffold _s mon-theme-sass	Télécharge le starter theme officiel Underscores et crée un thème propre avec structure SCSS et conventions modernes. Parfait pour démarrer un thème professionnel sur-mesure.

Utiliser wp scaffold, c’est s’assurer de partir sur une base saine, structurée et conforme aux standards WordPress. Cela évite les erreurs de départ, fait gagner un temps précieux et améliore la maintenabilité du code tout au long du projet. Ce système est particulièrement utile dans un environnement de développement collaboratif ou dans le cadre d’un framework d’agence, où la cohérence du code et la rapidité de mise en œuvre sont des critères stratégiques.

Import, export et migration de WordPress avec WP-CLI

La migration de contenu fait partie des tâches les plus courantes (et parfois sensibles) dans un projet WordPress. Qu’il s’agisse de transférer un site vers un nouvel hébergeur, de dupliquer un environnement de production en local, ou de faire un backup de contenu éditorial, WP-CLI propose des outils robustes pour automatiser ces processus. En particulier, les commandes wp export et wp import permettent de manipuler des fichiers WXR (WordPress eXtended RSS), le format standard pour l’échange de données entre installations WordPress.

Voici un tableau récapitulatif des principales commandes à connaître pour exporter, importer ou migrer des contenus WordPress via WP-CLI :

Commande	Description
wp export --dir=exports/	Exporte tout le contenu éditorial du site (articles, pages, médias, menus, etc.) au format WXR dans le répertoire exports/. Idéal pour créer une archive de migration ou de sauvegarde.
wp export --post_type=page	Exporte uniquement les pages. Utile si vous ne souhaitez transférer qu’un certain type de contenu lors d’une duplication partielle du site.
wp export --start_date=2023-01-01 --end_date=2023-12-31	Exporte uniquement les contenus créés entre deux dates. Recommandé pour des exports annuels, trimestriels ou pour isoler une période d’activité.
wp import mon-export.xml --authors=create	Importe un fichier WXR sur une autre installation WordPress. L’option --authors=create permet de créer automatiquement les auteurs mentionnés dans l’export.
wp import mon-export.xml --skip=attachment	Importe le contenu sans inclure les fichiers médias. Permet un gain de temps ou une importation partielle selon les besoins du projet.
wp media regenerate	Régénère les miniatures des images importées. À utiliser après un transfert si les tailles d’images ont été modifiées ou si certaines images ne s’affichent pas correctement.
wp search-replace 'https://ancien-domaine.com' 'https://nouveau-domaine.com'	Remplace les anciennes URL par les nouvelles dans toute la base. C’est une étape clé après une migration complète pour éviter les liens cassés ou le hotlinking.
wp search-replace '/var/www/old-path' '/var/www/new-path'	Met à jour les chemins d’accès aux fichiers ou aux médias lors d’un changement de structure de serveur ou de système de fichiers.
wp search-replace 'http' 'https' --skip-columns=guid	Force le passage en HTTPS dans le contenu, tout en évitant de modifier la colonne guid, ce qui pourrait affecter l’identification unique des contenus.

Vous pouvez ainsi exécuter une migration WordPress complète (contenu + structure + URL) de manière fiable, rapide et scriptable. Ces commandes sont précieuses pour les agences web, les freelances et les administrateurs techniques qui souhaitent standardiser leur process de livraison ou de duplication de sites.

Les outils système et tests avec WP-CLI

Au-delà de la gestion des contenus et des options, WP-CLI propose également des outils système pour développer, tester et diagnostiquer un site WordPress en profondeur. Ces commandes permettent de lancer un serveur local, d’exécuter du code PHP dynamiquement, ou encore d’identifier les goulots d’étranglement de performance dans le chargement de pages. Elles s’intègrent parfaitement dans un workflow de développement moderne ou dans des scripts de test automatisés.

Commande	Description
wp server --port=8000	Lance un serveur de développement PHP intégré (basé sur php -S) à l’adresse http://localhost:8000. Idéal pour tester un site local sans configuration Apache ou Nginx.
wp shell	Ouvre une console PHP interactive dans l’environnement WordPress. Permet d’exécuter et tester dynamiquement du code PHP avec accès complet au cœur, aux thèmes et plugins.
wp eval 'echo get_bloginfo("name");'	Exécute une instruction PHP directement dans le terminal. Utile pour des vérifications rapides ou pour interroger des fonctions spécifiques sans modifier de fichier.
wp eval-file mon-script.php	Charge et exécute un fichier PHP dans le contexte de WordPress. Pratique pour tester des scripts personnalisés ou faire des opérations ponctuelles sans les intégrer au thème.
wp profile stage all	Analyse les différents stages de chargement d’une requête WordPress (bootstrap, plugins, thèmes, requêtes SQL, etc.). Recommande pour identifier les lenteurs de chargement.
wp profile hook	Affiche le temps d’exécution des hooks et actions WordPress. Utile pour optimiser les performances et détecter les plugins ou fonctions trop gourmands.
wp cli info	Affiche la version de WP-CLI, PHP, OS, et d’autres informations système. Sert à diagnostiquer l’environnement d’exécution ou à documenter un projet.
wp cli check-update	Vérifie si une mise à jour de WP-CLI est disponible. Maintenir l’outil à jour garantit une compatibilité maximale avec les dernières versions de WordPress.
wp find	Scanne le système de fichiers pour identifier toutes les installations WordPress. Très pratique sur un serveur partagé ou un serveur de développement multisite.

Grâce à ces outils, WP-CLI devient un excellent utilitaire de gestion mais aussi un outil d’analyse, une solution de test et de développement. Il permet de diagnostiquer des problèmes, d’expérimenter rapidement du code, ou de lancer un environnement local en quelques secondes. Pour les développeurs avancés comme pour les administrateurs système, ces commandes constituent un véritable environnement de contrôle avancé pour WordPress.

La gestion Multisite WP via WP-CLI

Si vous gérez un réseau multisite, WP-CLI devient un allié indispensable pour automatiser la création, la suppression ou la configuration de sites au sein de ce réseau. Il facilite également la gestion des utilisateurs à l’échelle du réseau, y compris les super administrateurs, qui disposent de privilèges globaux sur tous les sites. Voici un petit tableau détaillant les principales commandes WP-CLI liées à la gestion d’un environnement WordPress Multisite :

Commande	Description
wp site list	Affiche tous les sites du réseau avec leur ID, domaine, chemin, statut et date d’enregistrement. Très utile pour avoir une vue d’ensemble rapide de la structure multisite.
wp site create --slug=blog2	Crée un nouveau site dans le réseau avec l’identifiant blog2. Selon la configuration, cela générera une URL de type exemple.com/blog2 ou blog2.exemple.com.
wp site delete 3	Supprime le site du réseau correspondant à l’ID 3. À utiliser avec précaution, car cela entraîne la perte des contenus et des utilisateurs liés à ce site.
wp site empty 4	Vide complètement le site avec l’ID 4 (articles, pages, médias, commentaires) sans supprimer la structure du site lui-même. Idéal pour réinitialiser un sous-site.
wp site activate 5	Réactive un site désactivé (statut « archived » ou « deleted »). Cela permet de restaurer un site mis en pause temporairement.
wp site deactivate 6	Désactive un site sans le supprimer définitivement. Cette commande peut être utile pour désactiver temporairement un site inactif ou en maintenance.
wp super-admin list	Affiche la liste des super administrateurs du réseau. Les super-admins ont le contrôle complet sur tous les sites du multisite.
wp super-admin add alice	Ajoute un utilisateur existant (ici alice) en tant que super administrateur. Il pourra alors accéder à tous les sites et à la gestion réseau.
wp super-admin remove bob	Retire le statut de super administrateur à l’utilisateur bob. Cette commande est utile pour limiter les privilèges d’un ancien administrateur global.
wp network meta list	Affiche les métadonnées réseau (similaires à wp_options, mais à l’échelle du multisite). Permet de consulter ou modifier des paramètres globaux du réseau.

De fait, la gestion d’un réseau multisite devient claire, structurée et entièrement scriptable. WP-CLI permet de créer rapidement de nouveaux sites, de gérer les accès administrateur, ou de réinitialiser des environnements sans passer par une interface graphique souvent limitée dans les cas complexes. Pour les hébergeurs, les agences multisite ou les grandes organisations, ces outils sont essentiels pour industrialiser la gestion de l’écosystème WordPress à grande échelle.

Divers usages complémentaires possibles avec WP-CLI

En plus de ses commandes de gestion de contenu, d’administration et de développement, WP-CLI propose des fonctionnalités complémentaires qui facilitent la vie des développeurs, administrateurs système ou formateurs WordPress. Ces commandes sont précieuses dans des contextes variés : audit de configuration, distribution de projets, détection d’installations multiples ou génération d’archives prêtes à déployer.

Commande	Description
wp cli info	Affiche les informations système relatives à WP-CLI : version, chemin de l’exécutable, version PHP, OS, etc. Très utile pour diagnostiquer l’environnement d’exécution et vérifier la compatibilité.
wp cli check-update	Vérifie si une nouvelle version de WP-CLI est disponible. Recommandé pour maintenir une installation à jour et profiter des dernières améliorations ou correctifs de sécurité.
wp find	Parcourt le système de fichiers à la recherche d’installations WordPress. Très pratique sur un serveur mutualisé ou un VPS où plusieurs sites cohabitent.
wp dist-archive .	Génère une archive ZIP du projet courant, en excluant les fichiers définis dans .distignore. Utile pour livrer un thème, un plugin ou un site prêt à installer.
wp cli alias list	Affiche les alias configurés pour interagir avec des sites distants. Permet d’administrer plusieurs environnements (local, préprod, prod) avec des raccourcis définis dans ~/.wp-cli/config.yml.
wp package install wp-cli/profile-command	Installe une commande WP-CLI additionnelle à partir du dépôt de packages communautaire. Permet d’étendre les fonctionnalités sans modifier le cœur de WP-CLI.
wp cli completions	Génère un script d’autocomplétion pour bash/zsh, facilitant l’utilisation interactive de WP-CLI. Idéal pour gagner en rapidité en ligne de commande.

Comme vous pouvez le constater, WP-CLI couvre pratiquement toutes les fonctionnalités de WordPress, de la simple installation à la gestion avancée multi-site, en passant par la génération de code, l’automatisation, l’audit, la maintenance, la sécurité, la traduction, et les performances. Ces usages complémentaires montrent que WP-CLI n’est pas seulement un outil de gestion, mais un véritable compagnon de développement WordPress, capable de s’adapter à tous les contextes d’utilisation, du freelance au DevOps en entreprise.

Quelques autres ressources pour maîtriser WP-CLI et en faire usage

Pour ceux qui souhaitent aller plus loin, la communauté WP-CLI propose une documentation riche, régulièrement mise à jour. Le handbook officiel est une excellente ressource pour comprendre l’architecture interne de l’outil, notamment si vous souhaitez développer vos propres commandes personnalisées. Le blog du projet WP-CLI publie également des mises à jour, des annonces de nouvelles versions, et des études de cas d’utilisation sur de gros projets WordPress automatisés via CLI. Enfin, si vous souhaitez contribuer, WP-CLI est un projet open-source maintenu activement. Vous pouvez proposer des améliorations, corriger des bugs ou créer des packages pour étendre ses fonctionnalités.

Vous l’avez compris, les WP-CLI commands constituent un véritable levier d’optimisation pour tous ceux qui travaillent avec WordPress de façon professionnelle. Que vous soyez développeur, administrateur système ou intégrateur, ces commandes vous permettent de gagner du temps, d’éviter les erreurs manuelles et d’automatiser vos tâches de maintenance ou de déploiement. En allant au-delà de l’interface graphique, WP-CLI ouvre la voie à des workflows modernes, reproductibles et robustes. Il n’est plus nécessaire de “cliquer” pour administrer : une simple ligne de commande suffit. C’est l’un des outils les plus puissants que vous puissiez ajouter à votre boîte à outils WordPress.