Guide d’installation de WP-CLI

By , Founder · Updated

WP-CLI est une interface en ligne de commande pour WordPress. Elle te permet d’installer des plugins, de gérer des utilisateurs, d’effectuer des opérations sur la base de données et bien plus encore — le tout depuis un terminal, sans toucher à l’interface d’administration WordPress. Ce guide couvre l’installation sur Linux, macOS et Windows, ainsi que les étapes de vérification et de dépannage pour les modes d’échec les plus courants.

En résumé : Sur Linux ou macOS (méthode phar), télécharge le fichier Phar, rends-le exécutable et déplace-le vers ton PATH. Sur macOS, la méthode la plus rapide est brew install wp-cli. Sur Windows, installe Cygwin ou utilise WSL2, puis suis les étapes Linux. Exécute wp --version pour confirmer que l’installation a fonctionné.

Référence rapide des plateformes et méthodes

Plateforme Méthode recommandée Alternative
Linux curl (phar) Composer
macOS Homebrew (brew install wp-cli) curl (phar)
Windows (Cygwin) curl (phar) dans le terminal Cygwin —
Windows (WSL2) Suivre les étapes Linux dans WSL2 —

WP-CLI peut également être installé en tant que package Composer ; consulte la documentation officielle de WP-CLI pour les instructions require wp-cli/wp-cli.

Prérequis

  • PHP 5.4 ou version ultérieure
  • WordPress 3.7 ou version ultérieure
  • Accès SSH à ton serveur pour les installations Linux
  • Privilèges administrateur pour les installations Windows

Installation sur Linux

  1. Télécharger WP-CLI :

Ouvre une fenêtre de terminal et télécharge le fichier Phar de WP-CLI avec curl :

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

Dans nos tests sur Ubuntu 22.04 LTS, la méthode curl s’achève en moins d’une minute avec une connexion serveur standard.

  1. Rendre WP-CLI exécutable :

Rends le fichier Phar téléchargé exécutable :

Bash
chmod +x wp-cli.phar
  1. Déplacer WP-CLI vers le répertoire bin :

Déplace l’exécutable vers un répertoire dans ton PATH. Le répertoire /usr/local/bin est l’emplacement standard :

Bash
sudo mv wp-cli.phar /usr/local/bin/wp
  1. Vérifier l’installation de WP-CLI :

Vérifie que WP-CLI est correctement installé en affichant ses informations système :

Bash
wp --info

Installation sur macOS

macOS est l’environnement de développement principal de nombreux développeurs WordPress. La méthode Homebrew est la plus simple et maintient WP-CLI à jour automatiquement.

Installation via Homebrew (recommandée)

Si tu as Homebrew installé, exécute :

brew install wp-cli

Après l’installation, confirme que ça fonctionne :

wp --version

Installation via Phar (sans Homebrew)

Si tu préfères la méthode manuelle, les étapes Linux Phar fonctionnent sur macOS sans modification :

curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
chmod +x wp-cli.phar
sudo mv wp-cli.phar /usr/local/bin/wp
wp --version

Installation sur Windows

  1. Télécharger WP-CLI :

Visite la page GitHub de WP-CLI et télécharge le dernier fichier Phar depuis :

Bash
https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
  1. Télécharger et installer Cygwin :

WP-CLI nécessite un terminal de type Unix. Télécharge et installe Cygwin depuis le site officiel :

Bash
https://www.cygwin.com/

Pendant l’installation, assure-toi d’installer les packages curl, php, php-curl, php-mbstring, openssl et openssh.

  1. Déplacer WP-CLI vers le répertoire Cygwin :

Déplace le fichier wp-cli.phar dans ton répertoire personnel Cygwin, généralement C:cygwin64homeYour_User.

  1. Rendre WP-CLI exécutable :

Ouvre le terminal Cygwin et navigue vers ton répertoire personnel avec cd ~. Rends ensuite le fichier Phar exécutable :

Bash
chmod +x wp-cli.phar
  1. Déplacer WP-CLI vers le répertoire bin :

Déplace l’exécutable vers ton PATH. Le répertoire /usr/bin dans Cygwin est l’emplacement standard :

Bash
mv wp-cli.phar /usr/bin/wp
  1. Vérifier l’installation de WP-CLI :

Vérifie que WP-CLI est correctement installé en affichant ses informations système :

Bash
wp --info

Vérifier l’installation

Après avoir installé WP-CLI par n’importe quelle méthode, confirme qu’il fonctionne avec deux commandes.

Vérifier la version :

wp --version

La commande affiche une chaîne de version telle que WP-CLI x.y.z. Consulte la page des versions de WP-CLI pour confirmer que tu as la dernière version.

Exécuter un contrôle de santé de base :

wp doctor check

Cela vérifie les problèmes de configuration courants. Exécute-le depuis un répertoire WordPress pour obtenir des résultats spécifiques au site. La commande doctor fait partie du package wp-cli/doctor-command, qui nécessite une installation séparée — consulte le README de wp-cli/doctor-command pour les instructions de configuration.

Dépannage

D’après les tickets de support de WP STAGING, la cause la plus fréquente des échecs d’installation de WP-CLI est une mauvaise configuration du PATH. Voici les principaux modes d’échec et leurs solutions.

wp: command not found après l’installation (Linux/macOS)

Le fichier Phar de WP-CLI n’a pas été placé dans un répertoire de ton $PATH. Confirme où wp a été déplacé :

which wp

Si la commande ne retourne rien, le binaire n’est pas dans ton PATH. Ajoute /usr/local/bin à ton PATH en éditant ~/.bashrc ou ~/.zshrc :

export PATH="$PATH:/usr/local/bin"
source ~/.bashrc

Puis réessaie wp --version.

PHP introuvable dans le PATH (Windows / Cygwin)

WP-CLI nécessite PHP accessible depuis le terminal. Dans Cygwin, vérifie que PHP est installé en exécutant php --version. Si cela retourne une erreur, relance le programme d’installation Cygwin et ajoute le package php.

Permission refusée sur le fichier Phar (Linux/macOS)

Si tu vois une erreur « Permission denied » lors du déplacement du fichier vers /usr/local/bin, préfixe la commande avec sudo :

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

Si sudo n’est pas disponible (par exemple sur un hébergement mutualisé), déplace le fichier vers un répertoire accessible en écriture par l’utilisateur (par ex. ~/bin/) et ajoute ce répertoire à ton PATH à la place.

Incompatibilité de version PHP

WP-CLI nécessite PHP 5.4 ou version ultérieure. Exécute php --version pour vérifier la version que ton terminal résout. Si tu as plusieurs versions de PHP installées, la version utilisée par WP-CLI est déterminée par l’ordre de ton PATH. Dans la plupart des cas, ce problème survient sur des serveurs exécutant une version PHP inférieure au minimum requis de 5.4 — mettre à niveau PHP pour répondre à l’exigence le résout. Consulte php.net/manual/en/install.php pour les instructions d’installation de PHP.

Conclusion

Maintenant que WP-CLI est installé, tu peux commencer à l’utiliser pour gérer ton site WordPress depuis la ligne de commande. La documentation officielle de WP-CLI couvre la référence complète des commandes et le guide.

Articles connexes

Updated on mai 23, 2026

Rene Hermenau

Auteur : Rene Hermenau

About the author: René Hermenau is the founder of WP STAGING. He works on WordPress backups, staging, migrations, database handling, and safe deployment workflows.