Aller au contenu principal
Deutsch English (United States) Español Nederlands

Installer WP-CLI

Mise à jour

WP-CLI est la ligne de commande de WordPress. Avec elle, tu pilotes cloneworx Backup sans navigateur, par exemple pour des sauvegardes que le serveur lance lui-même. Voici comment installer WP-CLI et vérifier que les commandes de l’extension sont disponibles.

Les étapes suivent le guide de hostnet : Wie installiere ich WP-CLI? L’utilisateur, le groupe et les chemins peuvent porter d’autres noms chez ton hébergeur.

Ce qu’il te faut

  • un accès SSH au serveur,
  • PHP pour la ligne de commande,
  • curl,
  • des droits sudo, si tu installes WP-CLI pour tout le serveur. Sans droits sudo, c’est possible aussi : voir la section « Sans droits sudo ».

Connecte-toi au serveur par SSH et place-toi dans un dossier où tu as le droit d’écrire, par exemple ton répertoire personnel.

Ne jamais exécuter WP-CLI en tant que root

WordPress, les extensions et les thèmes obtiendraient alors eux aussi les droits de root. Exécute WP-CLI en tant que l’utilisateur à qui appartient le site.

Étape 1 : télécharger WP-CLI

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

Le fichier wp-cli.phar se trouve ensuite dans le dossier où tu es actuellement.

Étape 2 : vérifier le fichier

php wp-cli.phar --info

La sortie indique les versions de PHP et de WP-CLI. Cette étape est optionnelle.

Étape 3 : rendre le fichier exécutable

chmod 755 wp-cli.phar

Avec ces droits, l’utilisateur du site peut lui aussi exécuter le fichier.

Étape 4 : installer WP-CLI pour tout le serveur

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

La commande déplace le fichier vers /usr/local/bin et le nomme wp. À partir de maintenant, tu appelles WP-CLI avec wp.

Étape 5 : tester en tant qu’utilisateur du site

sudo -u web -g vuser -H wp --info

Chez hostnet, le serveur web s’exécute en tant qu’utilisateur web dans le groupe vuser. Si l’utilisateur et le groupe portent d’autres noms chez toi, par exemple parce que ton site fonctionne avec suEXEC, tu indiques ici l’utilisateur et le groupe de ton site. Si la commande affiche les informations sur le système, PHP et WP-CLI sans message d’erreur, WP-CLI est installé.

Sans droits sudo

Si tu n’as pas de droits sudo, le fichier reste dans ton dossier et tu l’appelles avec PHP. Les étapes 3 à 5 ne s’appliquent pas.

# Au lieu de wp : php et le chemin du fichier
php ~/wp-cli.phar --info

L’exemple vaut pour un fichier qui se trouve dans ton répertoire personnel. Partout où cette aide indique wp, tu écris alors php et le chemin du fichier, ici php ~/wp-cli.phar.

Pour finir : les commandes de l’extension sont-elles disponibles ?

Place-toi dans le dossier de ton site, c’est-à-dire le dossier où se trouve WordPress. Demandes-y l’état du site :

# Dans le dossier du site
cd /pfad/zur/website
wp cloneworx-backup status

# Avec sudo en tant qu’utilisateur du site
sudo -u web -g vuser -H wp cloneworx-backup status

# Sans droits sudo, avec le fichier dans son propre dossier
php ~/wp-cli.phar cloneworx-backup status

La sortie est en anglais. La première ligne indique l’état du site, par exemple State: none (no backup yet) : il n’y a pas encore de sauvegarde. En dessous suivent entre autres la dernière sauvegarde, dès qu’il y en a une, et le nombre de plans et de destinations. C’est le même résultat que celui affiché par la tuile d’état de la page Vue d'ensemble.

Si la commande répond ainsi, les commandes de l’extension sont disponibles. Pour savoir lesquelles existent, consulte Les commandes en un coup d’œil.

Si quelque chose ne fonctionne pas

Ce qui se passe Ce que tu peux faire
Tu n’as pas le droit d’utiliser sudo. Suis la méthode de la section « Sans droits sudo ».
WP-CLI ne connaît pas la commande cloneworx-backup. L’extension n’enregistre ses commandes que si elle est active sur ce site. Vérifie que tu es dans le dossier du bon site et que cloneworx Backup y est activé. Sur une installation WordPress multisite, les commandes n’existent pas : cloneworx Backup ne prend pas en charge le multisite.
Une commande de l’extension s’interrompt. Son message contient This command runs as user et nomme deux utilisateurs. Tu travailles en tant qu’un autre utilisateur que celui à qui appartiennent les dossiers de l’extension. Exécute la commande en tant qu’utilisateur du site, comme à l’étape 5.

Bon à savoir

  • Les sorties de toutes les commandes de l’extension sont en anglais et ne sont pas traduites.
  • Presque chaque commande qui modifie quelque chose ou lance une tâche vérifie au préalable que tu travailles en tant que l’utilisateur à qui appartiennent les dossiers de l’extension. Le site ne pourrait plus modifier ni supprimer par la suite les fichiers et dossiers d’un autre utilisateur.
  • La ligne de commande n’accepte jamais de mots de passe ni de clés. Les destinations avec identifiants se configurent sur la page Destinations.

Voir aussi

Articles associés