Installation et utilisation de WP-CLI sur Windows

Guide complet : qu’est-ce que WP-CLI, à quoi il sert, comment l’installer, le configurer et l’utiliser sous Windows.

---

Qu’est-ce que WP-CLI

WP-CLI (WordPress Command Line Interface) est un outil en ligne de commande permettant de gérer un site WordPress sans utiliser de navigateur.

Il permet de :

• installer et mettre à jour WordPress ;
• gérer les extensions, les thèmes et les utilisateurs ;
• effectuer des recherches et remplacements dans la base de données ;
• automatiser des tâches via des scripts.

Site officiel : https://wp-cli.org

---

Pourquoi l’utiliser

Avantages de WP-CLI :

• Automatisation — vous pouvez écrire des scripts pour des opérations répétitives ou massives.
• Rapidité — plus rapide que l’interface graphique d’administration.
• Flexibilité — gestion de WordPress même sans interface web.
• Sécurité — permet de désactiver l’accès au tableau de bord et de travailler uniquement via la console.

---

Prérequis

• PHP 7.4 ou supérieur (8.x recommandé)
• WordPress 3.7 ou supérieur
• PHP CLI doit être accessible dans la variable PATH
• Connexion Internet pour télécharger les fichiers

Vérifier PHP :

php -v

---

Installation de WP-CLI sur Windows

1. Télécharger wp-cli.phar

Ouvrez PowerShell et exécutez :

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

(Vous pouvez aussi le télécharger manuellement et le placer dans C:\wp-cli\.)

---

2. Vérifier le fonctionnement

php C:\wp-cli\wp-cli.phar --info

Si les informations de version s’affichent, WP-CLI fonctionne correctement.

---

3. Créer le fichier wp.bat

Créez un fichier C:\wp-cli\wp.bat avec ce contenu :

@ECHO OFF
php "%~dp0wp-cli.phar" %*

Vous pouvez maintenant exécuter WP-CLI simplement avec wp.

---

4. Ajouter au PATH

Pour pouvoir utiliser wp depuis n’importe quel dossier :

setx PATH "$($env:PATH);C:\wp-cli" /M

Redémarrez PowerShell, puis testez :

wp --info

Si la commande fonctionne — l’installation est terminée.

---

Alternative : installation via Composer

composer global require wp-cli/wp-cli

Ensuite, ajoutez le chemin suivant :

%USERPROFILE%\AppData\Roaming\Composer\vendor\bin

---

Utilisation de WP-CLI

Exemples de commandes :

Installer WordPress :

wp core download --locale=fr_FR

Créer le fichier wp-config.php :

wp config create --dbname=wordpress --dbuser=root --dbpass=secret

Installer un site :

wp core install --url="http://localhost" --title="Mon Site" --admin_user=admin --admin_password=1234 --admin_email=test@example.com

Mettre à jour :

wp core update
wp plugin update --all

Utilisateurs :

wp user create editeur editeur@example.com --role=editor --user_pass=pass123

---

Commandes utiles

• wp plugin list — afficher la liste des extensions
• wp theme list — afficher les thèmes installés
• wp search-replace "http://ancien" "https://nouveau" — recherche et remplacement global
• wp db export / wp db import — sauvegarde et restauration de la base de données
• wp shell — ouvrir un shell PHP interactif

Liste complète : https://developer.wordpress.org/cli/commands/

---

Script PowerShell pour l’installation automatique

Enregistrez le script suivant comme install-wp-cli.ps1 et exécutez-le en tant qu’administrateur :

$targetDir = "C:\wp-cli"
$pharUrl   = "https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar"
$pharPath  = "$targetDir\wp-cli.phar"
$batPath   = "$targetDir\wp.bat"

Write-Host "Installation de WP-CLI..." -ForegroundColor Cyan

if (!(Test-Path $targetDir)) {
    New-Item -ItemType Directory -Force -Path $targetDir | Out-Null
}

Invoke-WebRequest -Uri $pharUrl -OutFile $pharPath

"@ECHO OFF
php ""%~dp0wp-cli.phar"" %*" | Out-File $batPath -Encoding ASCII

$envPath = [Environment]::GetEnvironmentVariable("Path", "Machine")
if ($envPath -notlike "*$targetDir*") {
    [Environment]::SetEnvironmentVariable("Path", "$envPath;$targetDir", "Machine")
    Write-Host "✅ Ajouté $targetDir au PATH (redémarrez la console)" -ForegroundColor Green
}

php $pharPath --info

Après exécution, vous pouvez tester :

wp --info

---

Conseils

• Exécutez PowerShell en tant qu’administrateur lors des modifications du PATH.
• Pour les sites distants, utilisez --ssh=<utilisateur>@<hôte>.
• En cas d’erreurs SSL, ajoutez --skip-ssl-check.
• Sauvegardez toujours la base de données avant les opérations massives.

---

Conclusion

WP-CLI est un outil puissant pour les administrateurs et développeurs WordPress.
Il permet de gagner du temps, d’automatiser les tâches et d’améliorer la sécurité et l’efficacité de la gestion.

Auteur : hypo69
Licence : MIT (https://opensource.org/licenses/MIT)