WP-CLI : le guide complet pour débutants sur WordPress + les commandes à maitriser

WP-CLI est l’un des outils les plus efficaces pour gagner du temps quand on gère un site WordPress. Au lieu de cliquer dans le tableau de bord pour mettre à jour des extensions, lister les thèmes, exporter une base de données ou créer un utilisateur, vous pouvez lancer une commande dans un terminal.

La promesse est simple : faire en quelques secondes ce qui prend parfois plusieurs minutes dans l’interface WordPress.

WordPress présente WP-CLI comme “the command line for WordPress” et précise qu’il permet de travailler sans navigateur. Il indique aussi que des actions comme installer des plugins, importer du contenu, créer des utilisateurs ou exécuter un search-replace peuvent être automatisées depuis le terminal.

Ce guide s’adresse aux débutants WordPress. Vous n’avez pas besoin d’être développeur pour comprendre WP-CLI. En revanche, vous devez apprendre quelques bases : ce qu’est un terminal, comment accéder au dossier de votre site, quelles commandes sont sûres, et quelles commandes peuvent casser un site si elles sont lancées sans sauvegarde.

Dans cette première partie, nous allons voir ce qu’est WP-CLI, pourquoi il peut vous faire gagner beaucoup de temps, comment vérifier s’il est déjà installé, comment l’installer, puis quelles premières commandes utiliser sans prendre de risque.

Qu’est-ce que WP-CLI ?

WP-CLI est l’interface en ligne de commande de WordPress. Elle permet de gérer un site WordPress depuis un terminal au lieu de passer par le tableau de bord. Avec WP-CLI, vous pouvez mettre à jour WordPress, gérer les plugins, modifier des utilisateurs, exporter une base de données ou automatiser des tâches répétitives.

WP-CLI signifie WordPress Command Line Interface. En français, on peut le traduire par interface en ligne de commande pour WordPress.

Concrètement, au lieu d’ouvrir votre navigateur, de vous connecter à /wp-admin, de cliquer sur “Extensions”, puis de mettre à jour un plugin, vous pouvez écrire une commande comme celle-ci :

wp plugin update nom-du-plugin

Et pour mettre à jour toutes les extensions d’un site :

wp plugin update --all

L’idée peut sembler intimidante au début. Pourtant, WP-CLI repose sur une logique très simple : chaque commande commence par wp, suivie d’un domaine d’action, puis d’une action précise.

Exemple :

wp plugin list

Cette commande signifie :

• wp : j’utilise WP-CLI ;
• plugin : je veux agir sur les extensions ;
• list : je veux les lister.

WP-CLI n’est donc pas une interface graphique. C’est un outil textuel. Vous écrivez une instruction, WordPress l’exécute, puis le terminal affiche le résultat.

La documentation développeur de WordPress liste de nombreuses familles de commandes disponibles : wp core, wp plugin, wp theme, wp user, wp db, wp cron, wp cache, wp post, entre autres.

WP-CLI est-il réservé aux développeurs ?

Non, WP-CLI n’est pas réservé aux développeurs. Un débutant peut l’utiliser pour des tâches simples comme lister les plugins, vérifier la version de WordPress ou exporter une base de données. En revanche, certaines commandes avancées doivent être utilisées avec prudence, surtout celles qui modifient ou suppriment des données.

WP-CLI est très utilisé par les développeurs, les agences WordPress, les administrateurs système et les hébergeurs. Mais cela ne veut pas dire qu’il est inutile pour les débutants.

Un utilisateur WordPress non technique peut déjà gagner du temps avec quelques commandes simples :

wp core version

Pour connaître la version de WordPress.

wp plugin list

Pour voir toutes les extensions installées.

wp theme list

Pour voir les thèmes présents sur le site.

wp db export backup.sql

Pour exporter une sauvegarde de la base de données.

Le vrai danger n’est pas WP-CLI lui-même. Le danger vient surtout du fait de copier une commande sans comprendre ce qu’elle fait.

Par exemple, cette commande peut être utile :

wp plugin deactivate contact-form-7

Elle désactive l’extension Contact Form 7. C’est pratique si un plugin bloque votre site.

Mais une commande comme celle-ci est beaucoup plus sensible :

wp db reset --yes

Elle réinitialise la base de données. Sur un site en production, cela peut provoquer une perte majeure de données. La documentation officielle de wp db montre d’ailleurs des sous-commandes puissantes comme drop, reset, import, export, repair ou optimize.

Pourquoi utiliser WP-CLI quand on débute sur WordPress ?

WP-CLI permet de gagner du temps sur les tâches répétitives de WordPress : mises à jour, vérifications, sauvegardes, gestion des plugins, utilisateurs et thèmes. Pour un débutant, son intérêt principal est de simplifier les actions longues ou bloquées dans le tableau de bord, à condition de toujours sauvegarder avant les commandes sensibles.

Quand on débute sur WordPress, on passe beaucoup de temps dans le tableau de bord : installer des plugins, activer un thème, vérifier les mises à jour, corriger une erreur, créer un utilisateur, vider un cache, tester une migration.

WP-CLI permet d’aller plus vite parce qu’il supprime une grande partie des clics.

Prenons un exemple simple. Pour vérifier les plugins installés depuis le tableau de bord, vous devez :

1. ouvrir le navigateur ;
2. vous connecter à WordPress ;
3. aller dans “Extensions” ;
4. attendre le chargement ;
5. consulter les statuts un par un.

Avec WP-CLI, une seule commande suffit :

wp plugin list

La documentation officielle de cette commande indique qu’elle affiche les extensions installées, leur état d’activation et la disponibilité éventuelle de mises à jour.

Autre cas très courant : votre site WordPress affiche une erreur critique après l’activation d’un plugin. Vous n’arrivez plus à accéder à l’administration. Depuis le tableau de bord, vous êtes bloqué. Avec WP-CLI, si vous avez encore accès au serveur, vous pouvez désactiver le plugin problématique :

wp plugin deactivate nom-du-plugin

C’est là que WP-CLI devient très utile : il vous donne une autre porte d’entrée quand l’interface WordPress ne répond plus.

WP-CLI est aussi pratique pour les sites avec beaucoup de plugins. Mettre à jour quinze extensions à la main prend du temps. Avec une commande, vous pouvez tout mettre à jour :

wp plugin update --all

Ce qu’il faut comprendre avant d’utiliser WP-CLI

Avant d’utiliser WP-CLI, vous devez comprendre quatre notions : le terminal, SSH, le dossier WordPress et la commande wp. Le terminal sert à écrire les commandes. SSH permet de se connecter à un serveur distant. Le dossier WordPress contient les fichiers du site. La commande wp permet d’exécuter WP-CLI.

Avant de copier des commandes, prenez quelques minutes pour comprendre l’environnement.

Le terminal

Le terminal est une fenêtre dans laquelle vous écrivez des commandes au lieu de cliquer sur des boutons.

Sur macOS et Linux, vous avez généralement une application appelée Terminal.
Sur Windows, vous pouvez utiliser PowerShell, Windows Terminal, Git Bash ou un terminal intégré à votre outil local.

Exemple de commande simple :

pwd

Cette commande affiche le dossier dans lequel vous vous trouvez.

ls

Cette commande liste les fichiers et dossiers présents.

cd nom-du-dossier

Cette commande permet d’entrer dans un dossier.

SSH

SSH est une méthode de connexion sécurisée à un serveur distant. Si votre site WordPress est hébergé chez un hébergeur web, vous aurez souvent besoin d’un accès SSH pour utiliser WP-CLI directement sur le serveur.

Selon votre hébergeur, WP-CLI peut être :

• déjà installé ;
• disponible uniquement sur certains plans ;
• accessible depuis un terminal intégré ;
• absent, avec installation manuelle nécessaire ;
• non autorisé sur certains hébergements très limités.

Avant d’installer quoi que ce soit, vérifiez donc dans votre espace client ou dans la documentation de votre hébergeur si WP-CLI est déjà disponible.

Le dossier WordPress

WP-CLI doit généralement être lancé depuis le dossier où WordPress est installé.

C’est souvent le dossier qui contient des fichiers comme :

wp-config.php
wp-admin
wp-content
wp-includes

Le fichier le plus important à repérer est :

wp-config.php

S’il est présent, vous êtes probablement dans le bon dossier WordPress.

Exemple :

ls

Si vous voyez wp-config.php, wp-content, wp-admin et wp-includes, vous êtes au bon endroit.

La commande wp

Toutes les commandes WP-CLI commencent par :

wp

Exemples :

wp --info
wp core version
wp plugin list
wp theme list
wp user list

Si vous tapez wp --info et que le terminal affiche des informations sur WP-CLI, PHP et votre système, c’est bon signe. Si le terminal répond que la commande wp est inconnue, WP-CLI n’est pas installé ou n’est pas accessible dans votre environnement.

Les précautions indispensables avant de lancer une commande

Avant de lancer une commande WP-CLI, vérifiez que vous êtes sur le bon site, dans le bon dossier, avec une sauvegarde récente. Commencez par des commandes de lecture comme wp --info, wp core version ou wp plugin list. Évitez les commandes de suppression, d’import ou de remplacement massif sans test préalable.

WP-CLI est rapide. C’est son avantage, mais aussi son risque. Une commande mal lancée peut produire un effet immédiat.

Avant d’utiliser une commande qui modifie le site, posez-vous toujours ces questions :

1. Suis-je sur le bon serveur ?
2. Suis-je dans le bon dossier WordPress ?
3. Est-ce un site de test ou un site en production ?
4. Ai-je une sauvegarde récente ?
5. Est-ce que je comprends ce que cette commande va faire ?
6. Existe-t-il une option de test comme --dry-run ?
7. Puis-je annuler facilement l’action ?

Pour débuter, utilisez d’abord des commandes qui lisent des informations sans modifier votre site :

wp --info

wp core version

wp plugin list

wp theme list

wp user list

Ces commandes sont utiles pour apprendre, car elles affichent des informations sans supprimer de données.

Les commandes à éviter au début sont celles qui contiennent des mots comme :

delete
drop
reset
import
search-replace

Elles ne sont pas interdites, mais elles nécessitent plus de prudence.

Comment savoir si WP-CLI est déjà installé ?

Pour savoir si WP-CLI est installé, ouvrez un terminal, placez-vous dans le dossier WordPress, puis lancez wp --info. Si WP-CLI est disponible, le terminal affiche des informations sur le système, PHP et la version de WP-CLI. Si la commande est inconnue, WP-CLI n’est pas installé ou n’est pas dans le PATH.

La première commande à tester est :

wp --info

Si tout fonctionne, vous verrez un résultat qui ressemble à ceci :

OS: Linux
Shell: /bin/bash
PHP binary: /usr/bin/php
PHP version: 8.x
WP-CLI version: 2.x

Le résultat exact dépend de votre serveur ou de votre ordinateur.

Cette commande ne modifie pas votre site. Elle sert uniquement à vérifier que WP-CLI répond correctement.

Si le terminal affiche une erreur comme :

command not found: wp

ou :

wp: command not found

cela signifie généralement que WP-CLI n’est pas installé ou que le système ne sait pas où trouver la commande wp.

Autre cas possible : WP-CLI est installé, mais vous n’êtes pas dans le bon dossier WordPress. Vous pouvez alors voir une erreur indiquant que WordPress ne semble pas être installé dans ce dossier. Dans ce cas, déplacez-vous vers le dossier contenant wp-config.php.

Exemple :

cd public_html

Puis relancez :

wp --info

ou :

wp core version

Comment installer WP-CLI ?

La méthode officielle recommandée consiste à télécharger le fichier Phar de WP-CLI, vérifier qu’il fonctionne, le rendre exécutable, puis le placer dans un dossier accessible avec la commande wp. WP-CLI nécessite PHP 7.2.24 ou plus récent, selon la documentation officielle d’installation.

Avant d’installer WP-CLI, vérifiez d’abord si votre hébergeur ne l’a pas déjà installé. Beaucoup d’environnements WordPress modernes proposent WP-CLI directement, surtout sur les offres avec SSH.

Pour vérifier votre version de PHP, lancez :

php --version

La documentation officielle indique que WP-CLI nécessite PHP 7.2.24 ou plus récent et qu’il n’a pas d’exigence supplémentaire au-delà de celles de WordPress lui-même.

Installation recommandée

La méthode recommandée par WP-CLI consiste à télécharger le fichier wp-cli.phar.

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

Ensuite, vérifiez que le fichier fonctionne :

php wp-cli.phar --info

Puis rendez-le exécutable :

chmod +x wp-cli.phar

Déplacez-le dans un emplacement accessible globalement :

sudo mv wp-cli.phar /usr/local/bin/wp

Enfin, testez :

wp --info

Si vous obtenez les informations de WP-CLI, l’installation fonctionne.

La documentation officielle recommande cette méthode avec le fichier Phar, puis conseille de lancer wp --info pour vérifier que l’installation est correcte.

Mettre à jour WP-CLI

Si vous avez installé WP-CLI avec la méthode Phar, la mise à jour peut se faire avec :

wp cli update

Selon les droits du serveur, vous devrez parfois utiliser :

sudo wp cli update

Avant de mettre à jour un outil système sur un serveur de production, vérifiez toujours avec votre hébergeur ou votre administrateur serveur.

Les premières commandes WP-CLI à tester

Les premières commandes à tester sont wp --info, wp core version, wp plugin list, wp theme list et wp help. Elles sont idéales pour débuter, car elles affichent des informations sans modifier votre site. Elles permettent de comprendre la logique WP-CLI avant de lancer des commandes plus puissantes.

Une bonne progression consiste à commencer par des commandes de lecture.

1. Vérifier WP-CLI

wp --info

Cette commande affiche les informations de l’environnement : système, shell, version de PHP, chemin du binaire PHP et version de WP-CLI.

Elle est utile pour vérifier que WP-CLI fonctionne.

2. Connaître la version de WordPress

wp core version

Cette commande affiche la version de WordPress installée.

Exemple :

6.5.5

La famille wp core sert à gérer le cœur de WordPress : téléchargement, installation, mise à jour, vérification des fichiers et affichage de version. La documentation officielle précise notamment que wp core version affiche la version de WordPress installée.

3. Lister les plugins

wp plugin list

Cette commande affiche les extensions installées.

Selon votre configuration, vous verrez des colonnes comme :

name
status
update
version

Cela vous permet de savoir rapidement quels plugins sont actifs, inactifs ou à mettre à jour.

4. Lister les thèmes

wp theme list

Cette commande affiche les thèmes installés sur le site.

Elle permet de voir quel thème est actif et quels thèmes sont simplement présents dans l’installation.

La famille wp theme inclut des actions comme activer un thème, installer un thème, lister les thèmes, supprimer des thèmes ou gérer les mises à jour.

5. Afficher l’aide

wp help

Cette commande affiche l’aide générale de WP-CLI.

Vous pouvez aussi demander de l’aide sur une commande précise :

wp help plugin

ou :

wp help plugin list

C’est une bonne habitude à prendre. Avant de copier une commande trouvée sur Internet, vérifiez ce que WP-CLI dit officiellement sur cette commande.

Comprendre la structure d’une commande WP-CLI

Une commande WP-CLI suit généralement une structure simple : wp, puis une catégorie, puis une action, puis parfois des options. Par exemple, wp plugin list liste les plugins, tandis que wp plugin update --all met à jour toutes les extensions. Les options commencent souvent par deux tirets, comme --all ou --format=json.

La plupart des commandes WP-CLI suivent cette forme :

wp catégorie action option

Exemple :

wp plugin list

Ici :

• wp lance WP-CLI ;
• plugin cible les extensions ;
• list demande la liste.

Autre exemple :

wp plugin update --all

Ici :

• wp lance WP-CLI ;
• plugin cible les extensions ;
• update demande une mise à jour ;
• --all indique que tous les plugins sont concernés.

Les options modifient le comportement d’une commande.

Exemples fréquents :

--all

Pour appliquer l’action à tous les éléments concernés.

--format=json

Pour afficher un résultat au format JSON.

--fields=name,status,version

Pour limiter les colonnes affichées.

--dry-run

Pour simuler une action sans l’appliquer, quand l’option est disponible.

La logique devient vite naturelle. Quand vous comprenez wp plugin list, vous pouvez deviner beaucoup d’autres commandes :

wp theme list
wp user list
wp post list

Même structure, autre catégorie.

Les commandes WP-CLI utiles pour gérer WordPress core

Les commandes wp core servent à gérer le cœur de WordPress. Pour un débutant, les plus utiles sont wp core version, wp core check-update, wp core update et wp core verify-checksums. Elles permettent de vérifier la version, contrôler les mises à jour, mettre à jour WordPress et vérifier l’intégrité des fichiers.

WordPress core désigne le cœur de WordPress, c’est-à-dire les fichiers principaux du CMS. Ce n’est ni votre thème, ni vos plugins, ni vos contenus.

Vérifier la version WordPress

wp core version

Utilité : savoir quelle version de WordPress est installée.

C’est souvent la première information demandée lors d’un diagnostic.

Vérifier les mises à jour disponibles

wp core check-update

Utilité : voir si une nouvelle version de WordPress est disponible.

Cette commande permet de vérifier avant d’agir.

Mettre à jour WordPress

wp core update

Utilité : mettre à jour WordPress vers une version plus récente.

Précaution : sauvegardez le site avant de lancer cette commande sur un site en production.

Mettre à jour la base de données après une mise à jour

wp core update-db

Utilité : exécuter la mise à jour de la base de données WordPress si nécessaire.

Cette commande est utile après certaines mises à jour majeures.

Vérifier l’intégrité des fichiers WordPress

wp core verify-checksums

Utilité : vérifier que les fichiers du cœur WordPress correspondent aux fichiers officiels.

La documentation officielle explique que cette commande télécharge les checksums MD5 de la version actuelle depuis WordPress.org et les compare aux fichiers installés.

C’est très utile si vous suspectez une modification anormale des fichiers WordPress.

Les commandes WP-CLI utiles pour gérer les plugins

Les commandes wp plugin permettent de lister, installer, activer, désactiver, mettre à jour ou supprimer des extensions WordPress. Pour débuter, les commandes les plus utiles sont wp plugin list, wp plugin install, wp plugin activate, wp plugin deactivate et wp plugin update --all.

Les plugins sont l’un des meilleurs cas d’usage de WP-CLI. Si vous gérez un site avec beaucoup d’extensions, vous pouvez gagner énormément de temps.

La documentation officielle de wp plugin liste des sous-commandes comme activate, deactivate, install, list, update, delete, uninstall ou encore verify-checksums.

Lister les plugins

wp plugin list

Utilité : afficher les plugins installés, leur statut, leur version et leurs mises à jour disponibles.

Vous pouvez aussi limiter les colonnes :

wp plugin list --fields=name,status,version,update

Cette version est plus lisible pour un diagnostic rapide.

Installer un plugin

wp plugin install wordpress-seo

Cette commande installe le plugin dont le slug est wordpress-seo.

Pour installer et activer immédiatement :

wp plugin install wordpress-seo --activate

La documentation officielle donne aussi des exemples d’installation avec activation via l’option --activate.

Activer un plugin

wp plugin activate wordpress-seo

Utilité : activer un plugin déjà installé.

Désactiver un plugin

wp plugin deactivate wordpress-seo

Utilité : désactiver un plugin sans le supprimer.

C’est l’une des commandes les plus utiles en dépannage. Si un plugin casse le site et bloque l’administration WordPress, vous pouvez le désactiver depuis le terminal.

Exemple pour désactiver tous les plugins :

wp plugin deactivate --all

Précaution : cette commande peut modifier fortement le comportement du site. Sur un WooCommerce, un site membre ou un site multilingue, désactiver tous les plugins peut provoquer des effets visibles pour les visiteurs.

Mettre à jour un plugin

wp plugin update wordpress-seo

Utilité : mettre à jour une extension précise.

Mettre à jour tous les plugins

wp plugin update --all

Utilité : mettre à jour toutes les extensions en une seule commande.

C’est très pratique, mais à utiliser avec méthode :

1. sauvegarder le site ;
2. vérifier les plugins critiques ;
3. tester sur staging si possible ;
4. lancer la commande ;
5. vérifier le site après mise à jour.

Vérifier si un plugin est actif

wp plugin is-active wordpress-seo

Cette commande est surtout utile dans des scripts, car elle renvoie un code de sortie indiquant si le plugin est actif ou non. La documentation officielle précise que la commande retourne un code 0 si le plugin est actif, et 1 s’il ne l’est pas.

Les commandes WP-CLI utiles pour gérer les thèmes

Les commandes wp theme permettent de lister, installer, activer, mettre à jour ou supprimer des thèmes WordPress. Pour un débutant, les plus utiles sont wp theme list, wp theme install, wp theme activate et wp theme update --all. Elles permettent de gérer l’apparence du site sans passer par le tableau de bord.

Après les plugins, les thèmes sont l’un des usages les plus simples de WP-CLI. Vous pouvez vérifier le thème actif, installer un nouveau thème, activer un thème de secours ou mettre à jour tous les thèmes installés.

La documentation officielle indique que la famille wp theme permet notamment de lister, rechercher, installer, activer, mettre à jour ou supprimer des thèmes.

Pour lister les thèmes installés :

wp theme list

Cette commande permet de voir rapidement le thème actif et les thèmes présents sur le site. C’est utile si vous reprenez un site WordPress et que vous voulez comprendre sa configuration.

Pour installer un thème depuis le répertoire officiel WordPress :

wp theme install twentytwentyfour

Pour installer et activer un thème immédiatement :

wp theme install twentytwentyfour --activate

La documentation officielle de wp theme install donne justement l’exemple d’une installation avec activation grâce à l’option --activate.

Pour activer un thème déjà installé :

wp theme activate twentytwentyfour

Cette commande change le thème actif du site. Elle peut donc modifier immédiatement l’apparence du site visible par les visiteurs.

Pour mettre à jour tous les thèmes :

wp theme update --all

Avant d’utiliser cette commande sur un site en production, vérifiez que votre thème actif n’a pas été modifié directement dans ses fichiers. Si vous avez personnalisé un thème sans thème enfant, une mise à jour peut écraser certaines modifications.

Pour supprimer un thème inutilisé :

wp theme delete nom-du-theme

Cette commande doit être utilisée avec prudence. Ne supprimez jamais le thème actif. Gardez aussi au moins un thème officiel de secours, comme un thème Twenty, pour pouvoir réactiver rapidement un thème propre en cas de problème.

Une bonne pratique consiste à lister les thèmes avant toute suppression :

wp theme list

Puis à supprimer uniquement les thèmes réellement inutiles :

wp theme delete ancien-theme

Les commandes WP-CLI utiles pour gérer les utilisateurs

Les commandes wp user permettent de lister, créer, modifier ou gérer les rôles des utilisateurs WordPress. Elles sont très utiles pour retrouver un compte administrateur, créer un accès temporaire ou vérifier les utilisateurs d’un site. Comme elles touchent aux accès, elles doivent être utilisées avec prudence.

Les utilisateurs WordPress peuvent être gérés depuis le tableau de bord, mais WP-CLI devient très pratique quand vous devez agir vite, surtout si l’administration est inaccessible.

La documentation officielle précise que wp user permet de gérer les utilisateurs, leurs rôles, leurs capacités et leurs métadonnées.

Pour lister les utilisateurs :

wp user list

Cette commande affiche les comptes présents sur le site. Elle peut vous aider à vérifier les administrateurs, éditeurs, auteurs, contributeurs et abonnés.

Pour afficher uniquement certaines colonnes :

wp user list --fields=ID,user_login,user_email,roles

Cette version est plus lisible pour un audit rapide.

Pour créer un utilisateur :

wp user create joseph joseph@example.com --role=administrator

Cette commande crée un utilisateur avec l’identifiant joseph, l’adresse joseph@example.com et le rôle administrateur.

La documentation officielle de wp user create indique que l’option --role permet de définir le rôle de l’utilisateur et cite notamment les rôles administrator, editor, author, contributor et subscriber.

Pour créer un utilisateur avec un mot de passe précis :

wp user create joseph joseph@example.com --role=administrator --user_pass='MotDePasseTresFort'

Cette méthode doit rester exceptionnelle. Évitez d’écrire un mot de passe sensible dans l’historique du terminal sur un serveur partagé. Après création, changez le mot de passe depuis WordPress ou utilisez un mot de passe temporaire.

Pour changer le rôle d’un utilisateur :

wp user set-role joseph editor

Cette commande donne le rôle éditeur à l’utilisateur joseph.

Pour repasser un utilisateur en administrateur :

wp user set-role joseph administrator

Cette commande est puissante. Ne donnez jamais le rôle administrateur à un compte dont vous n’êtes pas certain.

Pour obtenir les informations d’un utilisateur :

wp user get joseph

Pour mettre à jour l’adresse email d’un utilisateur :

wp user update joseph --user_email=nouvelleadresse@example.com

WP-CLI peut donc vous sauver dans un cas très concret : vous avez perdu l’accès au tableau de bord, mais vous avez encore un accès SSH. Vous pouvez créer un nouvel administrateur, vous reconnecter, puis corriger le problème depuis WordPress.

Les commandes WP-CLI utiles pour gérer les articles et les pages

Les commandes wp post permettent de lister, créer, modifier ou supprimer des articles et pages WordPress. Elles sont utiles pour faire des vérifications rapides, automatiser la création de contenus ou retrouver des contenus par statut. Les commandes de suppression doivent être utilisées avec une grande prudence.

Dans WP-CLI, le mot post ne désigne pas seulement les articles de blog. Il peut aussi concerner les pages, les contenus personnalisés et certains types de contenus créés par des plugins.

La documentation officielle indique que wp post permet notamment de créer, supprimer, modifier, lister ou mettre à jour des contenus.

Pour lister les derniers articles :

wp post list

Pour lister uniquement les pages :

wp post list --post_type=page

Pour afficher les brouillons :

wp post list --post_status=draft

Pour obtenir les identifiants des articles publiés :

wp post list --post_status=publish --format=ids

Cette commande est utile si vous voulez ensuite appliquer une action à plusieurs contenus.

Pour créer un article simple :

wp post create --post_type=post --post_title='Mon nouvel article' --post_status=draft

Cette commande crée un brouillon. C’est plus prudent que de publier directement.

Pour créer une page :

wp post create --post_type=page --post_title='À propos' --post_status=draft

Pour modifier le statut d’un article :

wp post update 123 --post_status=publish

Ici, 123 représente l’identifiant du contenu.

Pour supprimer un article :

wp post delete 123

Par défaut, la suppression peut envoyer le contenu à la corbeille selon le contexte. Mais avec l’option --force, la suppression devient définitive :

wp post delete 123 --force

La documentation officielle de wp post delete montre que l’option --force permet de supprimer un contenu en sautant la corbeille. C’est donc une commande à éviter pour les débutants, sauf si vous savez exactement ce que vous faites.

Les commandes WP-CLI utiles pour la base de données

Les commandes wp db permettent d’exporter, importer, optimiser, réparer ou manipuler la base de données WordPress. Elles sont très utiles pour les sauvegardes et les migrations, mais aussi très risquées. Avant toute commande wp db import, wp db reset ou wp search-replace, créez une sauvegarde complète.

La base de données est le cœur vivant de votre site WordPress. Elle contient vos articles, pages, réglages, utilisateurs, menus, commentaires, options de thème et données de plugins.

C’est pour cela que les commandes liées à la base de données doivent être traitées avec beaucoup de sérieux.

Pour exporter la base de données :

wp db export backup.sql

Cette commande crée un fichier SQL contenant la base de données. La documentation officielle précise que wp db export utilise les identifiants de base de données définis dans wp-config.php et s’appuie sur l’utilitaire mysqldump.

Vous pouvez aussi nommer le fichier avec une date :

wp db export backup-2026-06-01.sql

C’est une bonne pratique, car elle permet de retrouver facilement la sauvegarde.

Pour importer une base de données :

wp db import backup.sql

Cette commande exécute les requêtes SQL contenues dans le fichier. La documentation officielle indique que wp db import utilise les identifiants de wp-config.php et exécute les tâches définies dans le fichier SQL importé.

Attention : importer une base peut remplacer ou modifier des données existantes. Ne lancez jamais cette commande sans savoir ce que contient le fichier SQL.

Pour optimiser la base :

wp db optimize

Pour réparer la base :

wp db repair

Ces commandes peuvent aider dans certains cas, mais elles ne remplacent pas une vraie sauvegarde ni un diagnostic serveur.

Avant toute manipulation importante, vous pouvez donc utiliser cette séquence prudente :

wp db export backup-avant-modification.sql

Puis seulement après :

wp db optimize

La documentation WordPress sur les sauvegardes rappelle qu’une sauvegarde de base de données prend généralement la forme d’un fichier exporté, par exemple en .sql, .gz ou .bz2, et que sa restauration nécessite une réimportation dans MySQL ou MariaDB.

Utiliser WP-CLI pour changer une URL après migration

Après une migration WordPress, wp search-replace permet de remplacer une ancienne URL par une nouvelle dans la base de données. Il faut toujours commencer avec --dry-run pour simuler l’opération sans modifier le site. Une fois le résultat vérifié, la commande peut être relancée sans --dry-run.

Le changement d’URL est l’un des meilleurs cas d’usage de WP-CLI. Quand vous migrez un site de ancien-site.com vers nouveau-site.com, l’ancienne URL peut rester stockée dans la base de données : contenus, options, menus, widgets, constructeurs de pages, médias, etc.

Pour tester un remplacement sans rien modifier :

wp search-replace 'https://ancien-site.com' 'https://nouveau-site.com' --dry-run

L’option --dry-run est essentielle. Elle permet de voir ce qui serait remplacé sans appliquer les changements.

Si le résultat est correct, vous pouvez relancer la commande sans simulation :

wp search-replace 'https://ancien-site.com' 'https://nouveau-site.com'

La documentation officielle de wp search-replace liste des options avancées comme --all-tables, --all-tables-with-prefix ou --export, ce qui confirme que cette commande peut agir très largement sur la base. Elle doit donc être utilisée avec méthode.

WordPress recommande aussi WP-CLI search-replace comme l’une des méthodes possibles pour changer les occurrences d’une ancienne URL vers une nouvelle lors d’une migration, si l’hébergeur ou l’utilisateur a installé WP-CLI.

La bonne méthode pour un débutant est donc :

wp db export backup-avant-search-replace.sql

Puis :

wp search-replace 'https://ancien-site.com' 'https://nouveau-site.com' --dry-run

Puis, après vérification :

wp search-replace 'https://ancien-site.com' 'https://nouveau-site.com'

Enfin, vérifiez le site dans le navigateur : page d’accueil, articles, images, menus, formulaires, liens internes et tableau de bord.

Vider le cache avec WP-CLI

La commande wp cache flush permet de vider le cache objet WordPress. Elle peut être utile après une mise à jour, une migration ou une modification importante. Sur un site en production, surtout en multisite ou avec cache persistant, il faut l’utiliser avec prudence car elle peut avoir un impact temporaire sur les performances.

Le cache permet à WordPress de répondre plus vite en évitant de recalculer certaines informations à chaque chargement. Mais après une modification importante, il peut arriver que le site affiche encore une ancienne version d’une donnée.

Pour vider le cache objet :

wp cache flush

La documentation officielle précise que, sur un multisite WordPress avec cache objet persistant, vider le cache objet peut généralement vider le cache de tous les sites et avoir un impact sur les performances en production.

Cette commande ne vide pas forcément tous les caches de votre site. Selon votre configuration, vous pouvez aussi avoir :

• un cache de plugin ;
• un cache serveur ;
• un cache CDN ;
• un cache navigateur ;
• un cache d’hébergeur.

WP-CLI gère surtout le cache objet de WordPress. Pour les caches liés à un plugin ou à un hébergeur, il peut exister des commandes spécifiques, mais elles dépendent de l’outil utilisé.

Gérer les tâches cron avec WP-CLI

Les commandes wp cron permettent de vérifier, lister et exécuter les tâches planifiées WordPress. Elles sont utiles pour diagnostiquer les problèmes de publication programmée, d’emails, de sauvegardes automatiques ou de mises à jour. Pour un débutant, les commandes les plus sûres sont wp cron test et wp cron event list.

WordPress utilise un système appelé WP-Cron pour exécuter certaines tâches planifiées : publications programmées, vérifications de mises à jour, tâches de plugins, emails différés, sauvegardes automatiques, etc.

Pour tester si WP-Cron fonctionne :

wp cron test

La documentation officielle indique que wp cron test teste le système WP-Cron et signale notamment si la constante DISABLE_WP_CRON est active ou si le déclenchement HTTP pose problème.

Pour lister les événements cron programmés :

wp cron event list

La documentation officielle précise que cette commande affiche par défaut des champs comme hook, next_run_gmt, next_run_relative et recurrence.

Pour exécuter les événements dus maintenant :

wp cron event run --due-now

La documentation officielle de wp cron event montre que cette famille de commandes permet de lister, exécuter, planifier, supprimer ou déprogrammer des événements cron.

Pour un débutant, il vaut mieux éviter les commandes de suppression comme :

wp cron event delete nom_du_hook

ou :

wp cron event delete --all

Ces commandes peuvent désorganiser les tâches planifiées d’un plugin. Utilisez-les uniquement si vous savez quel hook vous ciblez.

Activer le mode maintenance avec WP-CLI

WP-CLI permet d’activer ou de désactiver le mode maintenance WordPress avec wp maintenance-mode activate et wp maintenance-mode deactivate. C’est utile pendant une mise à jour, une migration ou une intervention technique courte. Il faut toutefois penser à le désactiver dès que l’intervention est terminée.

Le mode maintenance indique aux visiteurs que le site est temporairement indisponible. C’est utile si vous effectuez une opération courte qui peut perturber l’affichage.

Pour activer le mode maintenance :

wp maintenance-mode activate

Pour vérifier son statut :

wp maintenance-mode status

Pour le désactiver :

wp maintenance-mode deactivate

La documentation officielle précise que wp maintenance-mode permet d’activer, désactiver ou vérifier le statut du mode maintenance d’un site.

Le risque principal est d’oublier le site en maintenance. Après chaque intervention, lancez toujours :

wp maintenance-mode status

Puis :

wp maintenance-mode deactivate

Si nécessaire.

Les commandes WP-CLI les plus risquées

Les commandes WP-CLI les plus risquées sont celles qui suppriment, remplacent ou importent des données : wp db import, wp db reset, wp search-replace, wp post delete --force, wp plugin delete ou wp theme delete. Elles doivent toujours être précédées d’une sauvegarde et, si possible, testées sur un environnement de staging.

WP-CLI est puissant parce qu’il permet d’agir vite. Mais une commande rapide peut aussi créer un problème rapide.

Voici les commandes à traiter avec prudence :

wp db import fichier.sql

Elle importe une base de données et peut remplacer des données existantes.

wp search-replace 'ancien' 'nouveau'

Elle remplace des valeurs dans la base de données. Utilisez d’abord --dry-run.

wp post delete 123 --force

Elle supprime un contenu sans passer par la corbeille.

wp plugin delete nom-du-plugin

Elle supprime les fichiers d’un plugin.

wp theme delete nom-du-theme

Elle supprime les fichiers d’un thème.

wp cache flush

Elle peut avoir un impact temporaire sur les performances si le site utilise un cache objet persistant, notamment en multisite.

Le bon réflexe est toujours le même : avant une commande dangereuse, exportez la base de données.

wp db export backup-avant-action-risquee.sql

Et si l’action concerne les fichiers, créez aussi une sauvegarde des fichiers WordPress, en particulier du dossier wp-content.

5 scénarios pratiques pour débutants

Les meilleurs scénarios pour apprendre WP-CLI sont les situations concrètes : mettre à jour les plugins, désactiver une extension qui casse le site, exporter une base de données, remplacer une URL après migration et créer un administrateur en urgence. Ces cas montrent immédiatement le gain de temps sans entrer dans un usage trop avancé.

Scénario 1 : mettre à jour tous les plugins

Avant tout :

wp db export backup-avant-maj-plugins.sql

Puis listez les plugins :

wp plugin list

Ensuite, lancez la mise à jour :

wp plugin update --all

Après la mise à jour, vérifiez le site dans le navigateur. Testez au minimum la page d’accueil, une page importante, un formulaire et le tableau de bord.

Scénario 2 : désactiver un plugin qui casse le site

Si le site affiche une erreur après l’activation d’un plugin, connectez-vous en SSH, placez-vous dans le dossier WordPress, puis listez les plugins :

wp plugin list

Désactivez le plugin suspect :

wp plugin deactivate nom-du-plugin

Si vous ne savez pas quel plugin pose problème, vous pouvez désactiver tous les plugins :

wp plugin deactivate --all

Puis les réactiver un par un depuis le tableau de bord ou avec WP-CLI.

Scénario 3 : exporter une base avant modification

Avant une intervention importante :

wp db export backup-avant-intervention.sql

Vérifiez ensuite que le fichier existe :

ls

Cette habitude simple peut vous éviter une catastrophe.

Scénario 4 : remplacer une URL après migration

Sauvegardez :

wp db export backup-avant-migration-url.sql

Simulez le remplacement :

wp search-replace 'https://ancien-site.com' 'https://nouveau-site.com' --dry-run

Appliquez seulement si le résultat est cohérent :

wp search-replace 'https://ancien-site.com' 'https://nouveau-site.com'

Puis videz le cache si nécessaire :

wp cache flush

Scénario 5 : créer un administrateur en urgence

Si vous avez perdu l’accès au tableau de bord mais que SSH fonctionne :

wp user create adminsecours adminsecours@example.com --role=administrator

Si vous voulez définir un mot de passe temporaire :

wp user create adminsecours adminsecours@example.com 
--role=administrator --user_pass='MotDePasseTemporaireTresFort'

Connectez-vous ensuite, créez un vrai mot de passe sécurisé, puis supprimez le compte temporaire si vous n’en avez plus besoin.

Les erreurs fréquentes avec WP-CLI

Les erreurs WP-CLI les plus fréquentes viennent d’un mauvais dossier, d’un accès SSH absent, d’une commande mal écrite, d’un problème de permissions, d’une version PHP incompatible ou d’un plugin qui bloque le chargement de WordPress. La première vérification consiste à lancer pwd, ls, puis wp --info.

“This does not seem to be a WordPress installation”

Cette erreur signifie souvent que vous n’êtes pas dans le dossier WordPress.

Vérifiez votre emplacement :

pwd

Listez les fichiers :

ls

Cherchez :

wp-config.phpwp-contentwp-adminwp-includes

Si vous ne les voyez pas, changez de dossier :

cd public_html

ou :

cd www

selon votre hébergeur.

“wp: command not found”

Cette erreur signifie que la commande wp n’est pas reconnue.

Causes possibles :

• WP-CLI n’est pas installé ;
• WP-CLI n’est pas dans le PATH ;
• vous n’utilisez pas le bon terminal ;
• l’hébergeur ne donne pas accès à WP-CLI.

Testez :

php --version

Puis vérifiez la documentation de votre hébergeur.

“Permission denied”

Cette erreur signifie que votre utilisateur serveur n’a pas les droits nécessaires.

Elle peut apparaître lors d’une installation, d’un déplacement de fichier ou d’une modification dans un dossier protégé.

Évitez d’utiliser sudo sans comprendre ce que vous faites. Sur un hébergement mutualisé, vous n’avez souvent pas les droits administrateur du serveur.

Erreur PHP

WP-CLI dépend de PHP. Si PHP est trop ancien, mal configuré ou différent entre le web et le terminal, certaines commandes peuvent échouer.

Commencez par :

php --version

Puis :

wp --info

Comparez la version de PHP utilisée par le terminal avec celle de votre site.

Un plugin bloque WP-CLI

Parfois, un plugin déclenche une erreur au chargement de WordPress. Vous pouvez essayer de lancer une commande en ignorant les plugins :

wp plugin list --skip-plugins

Ou en ignorant un plugin précis :

wp plugin list --skip-plugins=nom-du-plugin

Cette option est utile pour diagnostiquer un problème sans désactiver immédiatement le plugin.

Bonnes pratiques avant d’utiliser WP-CLI sur un site en production

Sur un site en production, utilisez WP-CLI avec une méthode stricte : sauvegarde, vérification du dossier, lecture de la commande, test avec --dry-run si possible, intervention hors période de trafic fort et contrôle du site après exécution. Ne lancez jamais une commande copiée sans comprendre son effet.

Avant toute action importante, commencez par vérifier où vous êtes :

pwd

Puis vérifiez que vous êtes dans le bon dossier :

ls

Ensuite, confirmez que WordPress répond :

wp core version

Avant une commande sensible, exportez la base :

wp db export backup-avant-action.sql

Si vous travaillez sur une migration ou une modification massive, cherchez toujours une option de simulation :

--dry-run

Pour search-replace, c’est indispensable.

Évitez aussi les interventions risquées aux heures de forte audience. Sur un site e-commerce, ne mettez pas tous les plugins à jour pendant une période de ventes importantes. Sur un média, évitez les heures de publication ou de trafic élevé.

Après l’intervention, testez le site comme un utilisateur :

• page d’accueil ;
• page article ;
• formulaire ;
• connexion ;
• panier si WooCommerce ;
• tableau de bord ;
• vitesse de chargement ;
• erreurs visibles.

WP-CLI ne remplace pas le contrôle humain. Il accélère l’action, mais vous devez toujours vérifier le résultat.

Tableau récapitulatif des commandes WP-CLI essentielles

Les commandes WP-CLI essentielles pour débuter sont celles qui affichent des informations, sauvegardent la base, listent les extensions, mettent à jour les plugins et aident au dépannage. Les commandes de suppression, d’import et de remplacement massif doivent être réservées aux cas où une sauvegarde existe.

WP-CLI peut-il remplacer le tableau de bord WordPress ?

WP-CLI ne remplace pas totalement le tableau de bord WordPress. Il le complète. Le tableau de bord reste plus confortable pour rédiger, concevoir des pages et gérer visuellement le site. WP-CLI est meilleur pour les tâches rapides, répétitives, techniques ou impossibles à faire quand l’administration est inaccessible.

Pour un débutant, le bon usage consiste à garder le tableau de bord pour les actions visuelles et éditoriales :

• écrire un article ;
• créer une page ;
• personnaliser un design ;
• configurer un plugin complexe ;
• gérer des médias ;
• vérifier le rendu du site.

WP-CLI est plus adapté pour :

• lister des plugins ;
• mettre à jour plusieurs extensions ;
• exporter une base ;
• changer une URL après migration ;
• créer un utilisateur ;
• désactiver un plugin bloquant ;
• lancer une vérification rapide ;
• automatiser une tâche.

Il ne faut donc pas opposer les deux. Le tableau de bord est l’interface confortable. WP-CLI est le raccourci puissant.

FAQ

WP-CLI est-il gratuit ?

Oui. WP-CLI est un outil open source de l’écosystème WordPress. Vous pouvez l’utiliser gratuitement si votre environnement technique le permet. L’accès dépend surtout de votre hébergeur, de votre serveur ou de votre installation locale.

WP-CLI est-il disponible chez tous les hébergeurs ?

Non. Certains hébergeurs l’installent par défaut, d’autres le proposent uniquement sur certaines offres, et certains environnements mutualisés limitent l’accès SSH. Le plus simple est de tester wp --info ou de consulter la documentation de votre hébergeur.

Faut-il connaître Linux pour utiliser WP-CLI ?

Pas forcément. Vous devez seulement comprendre quelques commandes de base comme cd, ls, pwd et savoir vous placer dans le dossier WordPress. Pour un usage débutant, quelques commandes suffisent déjà à gagner du temps.

WP-CLI peut-il casser mon site ?

Oui, si vous lancez une commande dangereuse sans comprendre son effet. Les commandes de lecture sont peu risquées. Les commandes de suppression, d’import, de remplacement massif ou de mise à jour globale doivent être précédées d’une sauvegarde.

Quelle commande lancer en premier ?

La première commande recommandée est :

wp --info

Elle permet de vérifier que WP-CLI fonctionne. Ensuite, testez :

wp core version

Puis :

wp plugin list

Comment désactiver un plugin avec WP-CLI ?

Utilisez :

wp plugin deactivate nom-du-plugin

Si vous ne connaissez pas le slug du plugin, lancez d’abord :

wp plugin list

Comment sauvegarder la base de données avec WP-CLI ?

Utilisez :

wp db export backup.sql

Vous pouvez aussi ajouter une date dans le nom du fichier :

wp db export backup-2026-06-01.sql

Comment mettre à jour tous les plugins avec WP-CLI ?

Utilisez :

wp plugin update --all

Sur un site en production, créez une sauvegarde avant :

wp db export backup-avant-maj.sql

Comment changer l’URL d’un site WordPress avec WP-CLI ?

Commencez par une simulation :

wp search-replace 'https://ancienne-url.com' 'https://nouvelle-url.com' --dry-run

Puis appliquez la commande uniquement si le résultat est correct :

wp search-replace 'https://ancienne-url.com' 'https://nouvelle-url.com'

WP-CLI fonctionne-t-il avec WooCommerce ?

Oui, WP-CLI peut fonctionner sur un site WooCommerce, mais les précautions doivent être plus strictes. Un site e-commerce contient des commandes, clients, paiements, stocks et emails. Sauvegardez toujours avant une commande sensible.

Peut-on utiliser WP-CLI sur Windows ?

Oui, mais l’expérience dépend de votre environnement. Vous pouvez utiliser Windows Terminal, PowerShell, Git Bash, WSL ou un outil local compatible WordPress. Si votre site est chez un hébergeur, vous utiliserez souvent SSH vers le serveur.

WP-CLI est-il utile pour un simple blog ?

Oui, surtout si vous gérez les mises à jour, les sauvegardes ou les migrations vous-même. Même sur un petit blog, des commandes comme wp plugin list, wp db export ou wp plugin update --all peuvent faire gagner du temps.

Conclusion : WP-CLI vaut-il le coup pour un débutant WordPress ?

Oui, WP-CLI vaut le coup pour un débutant WordPress s’il commence par les commandes simples et respecte les précautions de base. Il permet de gagner du temps, diagnostiquer plus vite et gérer certaines urgences sans passer par le tableau de bord. Le bon réflexe est d’apprendre progressivement, commande par commande.

WP-CLI peut faire peur au début parce qu’il passe par le terminal. Mais une fois les premières commandes comprises, l’outil devient très logique.

Vous n’avez pas besoin de tout apprendre. Pour commencer, retenez seulement ces commandes :

wp --infowp core versionwp plugin listwp theme listwp db export backup.sql

Avec ces cinq commandes, vous pouvez déjà vérifier votre environnement, connaître votre version WordPress, lister vos plugins, lister vos thèmes et sauvegarder votre base de données.

Ensuite, vous pouvez progresser vers les commandes plus utiles au quotidien :

wp plugin update --all
wp plugin deactivate nom-du-plugin
wp search-replace 'ancienne-url' 'nouvelle-url' --dry-run
wp cache flush
wp maintenance-mode activate
wp maintenance-mode deactivate

La règle la plus importante reste simple : ne lancez jamais une commande que vous ne comprenez pas, surtout sur un site en production.