WP-CLI transforme vite la gestion d’un site WordPress. Au lieu de cliquer partout dans l’administration, vous lancez une commande. Vous pouvez mettre à jour les extensions, vider les transients, vérifier l’état du site, régénérer les permaliens ou lancer un search-replace proprement.
Sur un hébergement Infomaniak, WP-CLI fonctionne très bien. Toutefois, il faut garder une chose en tête : vous êtes sur un hébergement Web avec accès SSH, pas sur un serveur root. Donc, on évite la méthode classique avec sudo mv wp-cli.phar /usr/local/bin/wp. À la place, on installe WP-CLI dans l’espace utilisateur, puis on ajoute ce dossier au PATH.
C’est plus propre, plus portable, et surtout compatible avec les limites normales d’un hébergement mutualisé. Bref, on fait les choses comme un admin civilisé. C’est rare, profitons-en.
Prérequis
Avant de commencer, vérifiez que vous avez :
- un hébergement Web Infomaniak avec accès SSH ;
- un site WordPress déjà installé ;
- un compte FTP + SSH actif ;
- un terminal local, ou la console SSH disponible dans le Manager Infomaniak.
Connectez-vous ensuite en SSH à votre hébergement. Une fois dans la session, commencez par vérifier la version de PHP utilisée en ligne de commande.
php -vCette étape compte, car WP-CLI s’exécute avec PHP en ligne de commande. Si la version CLI ne correspond pas à celle attendue par votre site WordPress, commencez par corriger ce point dans votre configuration Infomaniak.
Installer WP-CLI dans votre espace utilisateur
L’installation se fait en quatre temps : créer un dossier utilisateur pour les binaires, télécharger le fichier Phar officiel, le rendre exécutable, puis ajouter le dossier au PATH.
# Créer les dossiers nécessaires.
mkdir -p "$HOME/bin" "$HOME/.wp-cli"
# Télécharger le Phar officiel de WP-CLI.
curl -fL -o "$HOME/bin/wp" "https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar"
# Rendre la commande exécutable.
chmod 700 "$HOME/bin/wp"
# Tester WP-CLI directement avec son chemin complet.
"$HOME/bin/wp" --infoLangage du code : PHP (php)Si la commande "$HOME/bin/wp" --info affiche les informations de WP-CLI, l’installation fonctionne déjà. Il reste simplement à rendre la commande wp disponible partout dans votre session SSH.
Ajouter WP-CLI au PATH
Ajoutez maintenant $HOME/bin au PATH. La commande ci-dessous évite d’ajouter la même ligne plusieurs fois dans le fichier .bashrc.
# Ajouter $HOME/bin au PATH si ce n'est pas déjà fait.
grep -qxF 'export PATH="$HOME/bin:$PATH"' "$HOME/.bashrc" || echo 'export PATH="$HOME/bin:$PATH"' >> "$HOME/.bashrc"
# Recharger la configuration Bash.
source "$HOME/.bashrc"
# Vérifier que la commande wp est bien trouvée.
command -v wp
# Vérifier la version installée.
wp --versionLangage du code : PHP (php)Le retour de command -v wp doit normalement pointer vers un chemin du type :
/home/clients/.../bin/wpSi wp --version répond correctement, WP-CLI est disponible dans votre environnement SSH.
Forcer le chargement du .bashrc si nécessaire
Selon la configuration du shell, votre fichier .bashrc peut ne pas être chargé automatiquement à l’ouverture d’une session. Dans ce cas, ajoutez ce petit garde-fou dans .bash_profile.
# Créer .bash_profile si besoin, puis charger .bashrc depuis ce fichier.
touch "$HOME/.bash_profile"
grep -qxF '[ -f "$HOME/.bashrc" ] && source "$HOME/.bashrc"' "$HOME/.bash_profile" || echo '[ -f "$HOME/.bashrc" ] && source "$HOME/.bashrc"' >> "$HOME/.bash_profile"Langage du code : PHP (php)Fermez ensuite votre session SSH, reconnectez-vous, puis relancez :
wp --info
Utiliser WP-CLI dans le dossier WordPress
WP-CLI doit généralement être lancé depuis le dossier qui contient WordPress. Placez-vous donc dans le répertoire du site, puis testez une commande simple.
# Exemple : adaptez le chemin à votre hébergement.
cd "$HOME/sites/example.com"
# Vérifier que WP-CLI détecte bien WordPress.
wp core version
# Afficher quelques informations utiles.
wp option get siteurl
wp plugin list --status=activeLangage du code : PHP (php)Si WordPress n’est pas dans le dossier courant, vous pouvez aussi utiliser l’option --path.
wp --path="$HOME/sites/example.com" core versionLangage du code : JavaScript (javascript)Ajouter l’autocomplétion WP-CLI
Cette étape est facultative, mais très agréable au quotidien. Elle permet d’autocompléter les commandes WP-CLI avec la touche Tab.
# Télécharger le script d'autocomplétion.
curl -fL -o "$HOME/.wp-cli/wp-completion.bash" "https://raw.githubusercontent.com/wp-cli/wp-cli/master/utils/wp-completion.bash"
# Charger l'autocomplétion si le fichier existe.
grep -qxF '[ -f "$HOME/.wp-cli/wp-completion.bash" ] && source "$HOME/.wp-cli/wp-completion.bash"' "$HOME/.bashrc" || echo '[ -f "$HOME/.wp-cli/wp-completion.bash" ] && source "$HOME/.wp-cli/wp-completion.bash"' >> "$HOME/.bashrc"
# Recharger Bash.
source "$HOME/.bashrc"Langage du code : PHP (php)
Mettre WP-CLI à jour plus tard
Comme WP-CLI est installé dans votre dossier utilisateur, la mise à jour reste simple. Il suffit de retélécharger le Phar officiel au même emplacement.
curl -fL -o "$HOME/bin/wp" "https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar"
chmod 700 "$HOME/bin/wp"
wp --versionLangage du code : JavaScript (javascript)Vous pouvez aussi tenter la mise à jour interne de WP-CLI :
wp cli updateSur un hébergement mutualisé, je préfère toutefois la méthode par téléchargement direct. Elle reste explicite, prévisible, et ne dépend pas de permissions système que vous n’avez pas forcément.
Commandes utiles pour vérifier l’installation
Une fois WP-CLI installé, ces commandes permettent de vérifier rapidement que tout répond correctement.
# Chemin de la commande wp.
command -v wp
# Informations WP-CLI, PHP et système.
wp --info
# Version de WordPress.
wp core version
# URL du site.
wp option get siteurl
# Liste des extensions actives.
wp plugin list --status=active
# Vérifier les mises à jour disponibles.
wp plugin list --update=available
wp theme list --update=availableLangage du code : PHP (php)Problèmes fréquents
La commande wp est introuvable
Vérifiez d’abord que le fichier existe et qu’il est exécutable.
ls -l "$HOME/bin/wp"
echo "$PATH"
command -v wpLangage du code : PHP (php)Si $HOME/bin n’apparaît pas dans le PATH, rechargez votre configuration Bash.
source "$HOME/.bashrc"Langage du code : JavaScript (javascript)WP-CLI utilise une mauvaise version de PHP
Comparez la version PHP utilisée en CLI avec celle attendue par votre site.
php -v
wp --infoSi nécessaire, ajustez la version de PHP CLI dans votre configuration Infomaniak. C’est souvent le détail qui fait perdre dix minutes pour rien. Ou vingt. Restons polis.
WP-CLI ne trouve pas WordPress
Placez-vous dans le bon dossier, ou utilisez explicitement --path.
cd "$HOME/sites/example.com"
wp core version
# Ou :
wp --path="$HOME/sites/example.com" core versionLangage du code : PHP (php)Conclusion
WP-CLI s’installe très proprement sur un hébergement Infomaniak, à condition de rester dans l’espace utilisateur. Pas besoin de sudo, pas besoin de modifier le système, et pas besoin de bricoler dans des dossiers qui ne vous appartiennent pas.
Une fois la commande wp disponible dans le PATH, vous pouvez administrer votre site WordPress beaucoup plus vite depuis SSH. Pour un développeur, un intégrateur ou un webmaster qui maintient régulièrement un site, c’est vite indispensable.
