Installer WP-CLI sur un hébergement OVH

WP-CLI per­met d’administrer WordPress effi­ca­ce­ment en ligne de com­mande.
Sur un héber­ge­ment OVH, son ins­tal­la­tion est simple, mais un point pré­cis doit être res­pec­té pour que la com­mande reste dis­po­nible après une recon­nexion SSH.
Ce billet pro­pose une ins­tal­la­tion fonc­tion­nelle, durable et sans ambiguïté.

➔ Avant de com­men­cer, connectez-vous en SSH et assurez-vous d’être à la racine de votre héber­ge­ment (dos­sier per­son­nel, pas dans www), pour en être sûr, tapez cette commande :

cd ~

cd ~

Ensuite, copiez-collez ce code :

mkdir -p "$HOME/bin" &&
curl -o "$HOME/bin/wp" https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar &&
chmod +x "$HOME/bin/wp"

mkdir -p "$HOME/bin" &&
curl -o "$HOME/bin/wp" https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar &&
chmod +x "$HOME/bin/wp"

Puis ajoute le dos­sier au PATH :

echo 'export PATH="$HOME/bin:$PATH"' >> ~/.bash_profile

echo 'export PATH="$HOME/bin:$PATH"' >> ~/.bash_profile

Et recharge le profil :

source ~/.bash_profile

source ~/.bash_profile

Testez ensuite avec :

which wp

which wp

Vous devriez obte­nir quelque chose comme :

/home/votre_user/bin/wp

/home/votre_user/bin/wp

Et pour finir, véri­fiez en tapant :

wp --info

wp --info

Les lignes ci-dessus peuvent être copiées-collées telles quelles dans le ter­mi­nal, en une seule fois.

Comprendre les commandes : 

Si vous sou­hai­tez com­prendre ce que fait exac­te­ment chaque com­mande, et pour­quoi cette confi­gu­ra­tion est indis­pen­sable sur un héber­ge­ment OVH, les sec­tions sui­vantes détaillent chaque étape.

Télécharger WP-CLI dans l’espace utilisateur

mkdir -p "$HOME/bin"
curl -o "$HOME/bin/wp" https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
chmod +x "$HOME/bin/wp"

mkdir -p "$HOME/bin"
curl -o "$HOME/bin/wp" https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
chmod +x "$HOME/bin/wp"

WP-CLI est ins­tal­lé dans le dos­sier ~/bin, un empla­ce­ment stan­dard pour les exé­cu­tables uti­li­sa­teur. Le fichier est télé­char­gé puis ren­du exécutable.

Rendre la commande persistante (spécificité OVH)

echo 'export PATH="$HOME/bin:$PATH"' >> ~/.bash_profile

echo 'export PATH="$HOME/bin:$PATH"' >> ~/.bash_profile

Sur OVH, le fichier .bashrc n’est pas sys­té­ma­ti­que­ment char­gé à la connexion SSH.
Le PATH doit donc être défi­ni dans .bash_profile, sans quoi la com­mande wp devient introu­vable après déconnexion.

Cette étape est essen­tielle pour garan­tir la per­sis­tance de la com­mande après reconnexion.

Rechargez votre profil

source ~/.bash_profile

source ~/.bash_profile

Vérifier l’installation

which wp
wp --version

which wp
wp --version

Résultat atten­du :

• which wp retourne un che­min du type /home/votre_user/bin/wp ;
• wp --version affiche la ver­sion de WP-CLI uti­li­sée et confirme la bonne installation.

À retenir

• WP-CLI est ins­tal­lé une seule fois ;
• le fichier ~/bin/wp reste en place après déconnexion ;
• .bashrc ne suf­fit pas chez OVH ;
• .bash_profile est le bon fichier pour le PATH ;
• une fois confi­gu­ré, WP-CLI fonc­tionne durablement.