WP-CLI : administrer WordPress depuis le terminal

WP-CLI permet de consulter et d'administrer WordPress depuis le terminal. Utilisez-le avec l'utilisateur du compte et sur la bonne installation : beaucoup de commandes peuvent modifier des données sans afficher de formulaire de confirmation.

Installer WP-CLI

Connectez-vous en SSH et vérifiez d'abord s'il est disponible :

command -v wp
wp --info

S'il manque, suivez l'installation officielle avec un PHP compatible. Pour l'installer avec Composer sur votre compte, utilisez le paquet complet :

composer global require wp-cli/wp-cli-bundle
composer global config bin-dir --absolute

La deuxième commande affiche le dossier des exécutables. Si wp est introuvable, ajoutez-le au PATH et vérifiez de nouveau wp --info. Le PHP du terminal peut différer du PHP web ; n'ignorez pas les prérequis de Composer pour forcer l'installation.

Avant d'exécuter des commandes qui modifient des données

Placez-vous dans la bonne racine et vérifiez l'identité du site :

pwd
wp core version
wp option get home
wp option get siteurl

Préparez une sauvegarde des fichiers et de la base. Cet exemple exporte le SQL vers un répertoire privé hors de la racine publique ; remplacez le chemin avant de l'exécuter et ne réutilisez pas le nom d'une sauvegarde existante :

umask 077
wp db export /RUTA_PRIVADA_FUERA_DEL_WEBROOT/wp-antes-del-cambio.sql
sha256sum /RUTA_PRIVADA_FUERA_DEL_WEBROOT/wp-antes-del-cambio.sql

Conservez le fichier et sa somme de contrôle hors de l'hébergement et testez la restauration. La somme de contrôle sert à détecter une modification du fichier ; elle ne prouve pas que la sauvegarde est complète ou restaurable.

Testez les changements sur un clone, utilisez --dry-run quand l'option existe et vérifiez la portée avant de la retirer. S'il y a des écritures continues, prévoyez comment ne pas les perdre en cas de retour arrière.

Installer WordPress

Dans une destination vide et protégée, téléchargez le cœur :

wp core download

Créez d'abord une base et un utilisateur SQL dédiés. Remplacez les valeurs de l'exemple et saisissez le mot de passe à l'invite :

wp config create --dbname=base_datos \
  --dbuser=usuario \
  --dbhost=localhost \
  --dbprefix=wp_ \
  --prompt=dbpass

Configurez le site avec votre propre compte administrateur :

wp core install --url=https://dominio.example \
  --title=Sitio \
  --admin_user=administrador_ejemplo \
  --admin_email=administrador@dominio.example \
  --prompt=admin_password

Les domaines et les utilisateurs sont des exemples. Ne mettez pas de mots de passe dans les arguments et ne les publiez pas dans des journaux. Vérifiez le HTTPS et l'accès avant de retirer la protection de la destination.

Réinstaller WordPress

La réinstallation doit conserver la version et la langue si vous voulez seulement réparer des fichiers. Remplacez les marqueurs par les valeurs vérifiées :

wp core download --version=VERSION_INSTALADA --locale=LOCALE_INSTALADO --skip-content --force
wp core verify-checksums --include-root

--force écrase les fichiers du paquet, mais ne supprime pas tous les fichiers étrangers. Sans version explicite, vous pouvez en télécharger une autre. Cela ne nettoie pas à lui seul une intrusion dans les extensions, les utilisateurs ou la base de données.

Changer l'URL principale de WordPress

Pour une installation simple où WordPress et le site public partagent la même racine, ces commandes changent les valeurs dans la base :

wp option update home 'https://nuevodominio.example'
wp option update siteurl 'https://nuevodominio.example'

Si le cœur se trouve dans un autre sous-répertoire, les deux valeurs peuvent être différentes. Vérifiez aussi les constantes de wp-config.php, le Multisite, le DNS et les certificats. Changer les options ne remplace pas toutes les références dans le contenu.

Lister les extensions

wp plugin list

Vérifiez le slug, l'état et la version. Si une extension empêche WordPress de démarrer, certaines requêtes acceptent --skip-plugins ; les mu-plugins peuvent continuer à se charger. Ce n'est pas une réparation du composant.

Installer des extensions

Cherchez le slug officiel et vérifiez la compatibilité avant d'installer :

wp plugin search 'termino de busqueda'
wp plugin install SLUG_DEL_PLUGIN

Installer et activer sont deux actions distinctes. Ajoutez --activate uniquement si vous voulez activer ce composant et que vous avez vérifié ses dépendances. Pour un ZIP commercial, utilisez le paquet vérifiable du fournisseur ; n'exposez pas de clés de téléchargement dans l'historique.

Désactiver une ou plusieurs extensions

wp plugin deactivate SLUG_DEL_PLUGIN

Remplacez le marqueur par le slug réel. --all affecte toutes les extensions de la portée : cela peut arrêter les paiements, la sécurité ou les formulaires. En Multisite, vérifiez aussi l'activation réseau. Ne désactivez pas tout en masse sur une boutique ouverte pour tester une hypothèse.

Mettre à jour les extensions

wp plugin update SLUG_DEL_PLUGIN --dry-run

Examinez les mises à jour proposées, préparez la sauvegarde et testez le changement. Pour l'appliquer, relancez sans --dry-run, uniquement dans le cadre de la procédure vérifiée. Vérifiez ensuite le fonctionnement de l'extension ; une sortie sans erreur ne prouve pas le bon déroulement du processus métier.

Rechercher et remplacer en masse dans la base de données

WP-CLI sait traiter les données sérialisées, mais la portée reste déterminante. Cet exemple limite la simulation à deux tables ; remplacez leurs noms si le préfixe est différent :

wp search-replace 'https://antiguo.example' 'https://nuevo.example' wp_posts wp_postmeta \
  --skip-columns=guid --precise --report-changed-only --dry-run

Examinez le rapport et des échantillons avant de relancer sans --dry-run. Ce n'est pas une migration complète : les options, les tables des extensions et un réseau Multisite peuvent demander un autre traitement. Les GUID ne doivent pas être changés par habitude lors du déplacement du site. Consultez la référence de search-replace.

Expressions régulières et contenu HTML

--regex accepte des motifs, mais une expression régulière n'est pas un analyseur HTML. L'ancien exemple qui supprimait les iframes pouvait correspondre à d'autres blocs ou ignorer des variantes ; ne l'exécutez pas en masse sans une sélection vérifiée.

Pour retirer une iframe précise, identifiez d'abord les articles et le champ, puis modifiez le bloc exact via l'API ou l'éditeur de l'application. Si vous devez automatiser du HTML variable, préparez un script qui reconnaît l'élément et son URL et compare l'avant et l'après sur des échantillons, y compris des cas qui ne doivent pas changer. Un simple comptage des correspondances ne suffit pas.

Importer et exporter la base de données

wp db export et wp db import utilisent la connexion configurée. Une importation peut remplacer des tables ou mélanger des données. Testez la restauration dans une nouvelle base, depuis un clone qui pointe explicitement vers elle ; vérifiez le schéma, le contenu et les fonctions avant la bascule finale.

Gardez l'ancienne base intacte pendant la période de récupération et conservez le SQL hors des répertoires publics. N'importez pas une ancienne sauvegarde sur une boutique qui continue de recevoir des commandes.

Lister les événements wp-cron

wp cron event list

Affiche les événements planifiés, leur prochaine exécution et leur récurrence. Ce n'est pas un historique des exécutions terminées et cela ne prouve pas qu'une tâche s'est bien terminée. Comparez les événements en retard avec le mécanisme de cron et les journaux de l'application ; lancer des tâches manuellement peut envoyer des e-mails ou effectuer d'autres actions.