WP-CLI est l’interface en ligne de commande de WordPress. Elle donne accès à de nombreuses opérations d’administration sans passer par le tableau de bord : mises à jour, gestion des extensions, base de données, diagnostic ou automatisation. Pour une agence ou un administrateur technique, elle devient particulièrement utile dès qu’une tâche doit être répétée, documentée ou exécutée sur plusieurs environnements.
Dans cet article, nous nous concentrons sur les usages qui apportent une vraie valeur en maintenance et en développement WordPress, avec les précautions nécessaires avant toute opération sensible.
Note d’actualisation — août 2026 : cet article a été restructuré afin de corriger la procédure d’installation, d’intégrer les paramètres globaux les plus utiles et de mieux couvrir l’administration de la base de données, les contrôles d’intégrité et le diagnostic.
Sommaire de l’article
Qu’est-ce que WP-CLI et dans quels cas l’utiliser ?
WP-CLI exécute des actions WordPress directement depuis un terminal. Une commande suit généralement une logique simple : wp, puis une commande principale et une sous-commande. La même interface sert à interroger l’installation, modifier un réglage, gérer une extension ou lancer une opération sur la base de données.
Son intérêt apparaît surtout lorsque l’interface d’administration serait plus lente ou moins précise. WP-CLI facilite les tâches répétitives, les opérations sur plusieurs sites, les migrations et certains diagnostics lorsque le back-office est inaccessible ou trop lent.
Avant de lancer une commande WP-CLI
WP-CLI agit directement sur WordPress et exécute en quelques secondes des opérations qui touchent la configuration, les fichiers ou la base de données. Avant toute commande sensible, confirmez l’environnement d’exécution et préparez un retour arrière.
SSH, répertoire et environnement
WP-CLI doit cibler la bonne installation WordPress. Vérifiez d’abord le serveur, le répertoire courant et l’environnement concerné. Le paramètre global --path désigne explicitement le chemin de WordPress, tandis que --url sélectionne le site lorsque le contexte l’exige. Le paramètre --ssh sert également à exécuter une commande sur une installation distante lorsque l’accès SSH est configuré.
Les droits du compte système restent tout aussi importants. Exécuter WP-CLI avec un utilisateur disposant de privilèges excessifs augmente l’impact d’une erreur. Le bon réflexe consiste à travailler avec les accès nécessaires au site visé, puis à confirmer l’environnement avant toute commande destructive.
Sauvegarde, dry-run et secrets
Avant une migration, un remplacement massif ou une modification importante de la base, créez un point de restauration. wp db export génère rapidement un export SQL. Pour les opérations de remplacement, wp search-replace accepte l’option --dry-run afin d’afficher les changements attendus sans écrire dans la base.
Évitez également d’inscrire des mots de passe dans un historique de terminal ou un script partagé. WP-CLI propose le paramètre global --prompt pour demander certaines valeurs de manière interactive. Les scripts d’automatisation gagnent aussi à s’appuyer sur des variables d’environnement ou sur le gestionnaire de secrets de l’infrastructure.
Installer ou accéder à WP-CLI
Sur de nombreux hébergements WordPress managés, WP-CLI est déjà disponible via SSH. C’est notamment le cas des environnements Kinsta utilisés par Evolyon. Avant toute installation manuelle, commencez donc par vérifier les outils fournis par l’hébergeur.
Pour une installation locale ou un serveur qui ne l’intègre pas, le handbook officiel WP-CLI documente les méthodes actuelles. Pour replacer ces outils dans l’évolution de la documentation technique du CMS, notre article consacré au Codex WordPress présente également les ressources officielles qui lui ont succédé. Une installation complète de WordPress suit ensuite une séquence logique : télécharger le cœur avec wp core download, créer wp-config.php avec wp config create, créer la base avec wp db create, puis lancer wp core install. Les paramètres d’administration utilisent notamment --admin_user, --admin_email et --admin_password.
Comprendre la syntaxe et les paramètres globaux
La commande wp help affiche l’aide générale ou celle d’une commande précise. wp core version retourne la version du cœur WordPress installée. Cette logique commande / sous-commande rend l’outil assez lisible une fois les premières familles de commandes identifiées.
Les paramètres globaux apportent une grande partie de la souplesse de WP-CLI. --path cible une installation, --url précise le site, --user exécute l’action dans le contexte d’un utilisateur WordPress, --skip-plugins et --skip-themes facilitent certains diagnostics, tandis que --debug enrichit les informations affichées lorsqu’une commande échoue.
Gérer WordPress, les plugins et les thèmes
WP-CLI couvre les opérations courantes sur le cœur, les extensions et les thèmes. wp plugin list inventorie les plugins, wp plugin install en installe un, wp plugin activate l’active et wp plugin update applique une mise à jour. Les commandes wp theme suivent une logique comparable pour les thèmes.
La commande wp plugin update --all simplifie fortement une maintenance, mais elle ne remplace pas une stratégie de validation. Sur un site sensible, commencez par examiner les mises à jour disponibles, créez une sauvegarde et testez les évolutions les plus importantes avant de les appliquer en production. Notre article sur la mise à jour de WordPress détaille cette logique.
Administrer la base de données avec WP-CLI
WP-CLI devient particulièrement efficace lorsqu’une intervention concerne la base de données WordPress. wp db export crée un export SQL, wp db import importe un fichier, wp db tables liste les tables et wp db size aide à mesurer leur volume.
Pour une migration ou un changement d’URL, wp search-replace traite correctement les données sérialisées WordPress. Commencez par un --dry-run afin d’examiner le nombre de remplacements et les tables concernées. Une fois le résultat validé et la sauvegarde disponible, l’opération réelle devient beaucoup plus maîtrisée.
Maintenance et sécurité avec WP-CLI
WP-CLI accélère plusieurs opérations de maintenance qui seraient plus longues à exécuter depuis l’administration. Les commandes restent à employer avec méthode, notamment lorsqu’elles touchent les données temporaires ou l’intégrité des fichiers.
Nettoyer les transients expirés
Les transients stockent temporairement des données calculées ou récupérées par WordPress et ses extensions. wp transient delete --expired supprime uniquement les valeurs arrivées à expiration. wp transient delete --all efface aussi les valeurs encore valides ; cette seconde commande relève donc davantage du dépannage que de l’entretien courant.
Lorsqu’un cache objet persistant comme Redis ou Memcached est actif, une partie de ces données temporaires peut être gérée hors de la base. L’analyse doit donc tenir compte de l’infrastructure avant d’interpréter le volume des transients comme un problème.
Vérifier l’intégrité des fichiers
wp core verify-checksums compare les fichiers du cœur avec les checksums officiels WordPress.org. Cette vérification aide à repérer un fichier altéré ou inattendu lors d’un diagnostic. Pour les plugins disponibles sur WordPress.org, wp plugin verify-checksums --all applique une logique comparable.
Les extensions premium, privées ou personnalisées ne disposent pas toujours de checksums publics. Une anomalie détectée n’est par ailleurs qu’un signal : la réinstallation depuis une source saine ou une analyse de sécurité restent des étapes distinctes. Ce type de contrôle complète les mesures décrites dans notre guide pour sécuriser un site WordPress.
Diagnostiquer WordPress avec WP Profile et WP Doctor
WP Profile et WP Doctor sont des packages complémentaires de WP-CLI, et non des commandes intégrées au cœur de l’outil. WP Profile mesure le temps passé dans différentes étapes de chargement afin d’identifier un plugin, un hook ou une opération coûteuse. WP Doctor exécute quant à lui une série de contrôles ciblés sur l’état de WordPress.
Ces packages se révèlent particulièrement utiles lorsqu’un site ralentit ou se comporte de manière anormale. Ils complètent les outils de monitoring et les mesures navigateur : WP-CLI observe surtout ce qui se passe côté WordPress et PHP, tandis que les Core Web Vitals décrivent l’expérience dans le navigateur.
Automatiser et administrer plusieurs sites
La ligne de commande prend tout son intérêt lorsqu’une même opération concerne plusieurs installations. Des scripts shell peuvent enchaîner des contrôles, exports ou mises à jour, à condition de conserver des garde-fous et des journaux exploitables. L’option --ssh facilite également l’administration distante depuis un environnement de travail centralisé.
Évitez de figer des identifiants ou mots de passe dans les scripts. Les variables d’environnement, les mécanismes de secrets de l’hébergeur et les invites interactives limitent l’exposition. L’automatisation doit réduire les manipulations répétitives sans supprimer les validations nécessaires avant une opération destructive.
Pourquoi WP-CLI est particulièrement utile en maintenance WordPress
WP-CLI ne remplace ni l’analyse technique ni les procédures de maintenance. Il fournit surtout une interface rapide et reproductible pour agir sur WordPress lorsque le tableau de bord devient trop lent, inaccessible ou simplement moins adapté à la tâche.
Chez Evolyon, cet outil s’intègre naturellement à certaines opérations de maintenance WordPress : diagnostic, contrôle de l’installation, intervention sur la base ou gestion technique de plusieurs environnements. Sa force réside moins dans une commande isolée que dans la capacité à exécuter une procédure précise de manière cohérente et traçable.
