WP-CLI est l'outil que les ops WordPress finissent tous par adopter. Là où l'admin WordPress prend dix clics pour faire une opération de masse, WP-CLI la règle en une ligne. Voici les cinq commandes qu'on lance le plus chez WPHelp247, avec leurs usages réels et les pièges à éviter.

1. wp search-replace : changer un domaine sans casser les arrays sérialisés

C'est probablement la commande la plus utilisée en migration et en duplication d'environnement. Le piège classique d'un sed brutal sur un dump SQL : les arrays PHP sérialisés (les options WordPress, les meta) cassent dès qu'on touche à un domaine, parce que la longueur de la string est stockée et ne matche plus après remplacement. WP-CLI gère ça nativement.

Exemple typique pour passer un staging en production :

  • `wp search-replace "staging.exemple.com" "www.exemple.com" --all-tables --skip-columns=guid`
  • `--skip-columns=guid` parce que le guid WordPress sert d'identifiant historique : si on le change, certains lecteurs RSS perdent le fil.
  • `--dry-run` en premier passage pour voir le nombre de remplacements avant de toucher la base.

2. wp transient delete --all : vider les caches après une refonte

WordPress accumule des transients (caches d'options) qui survivent aux mises à jour. Après une refonte, un changement de thème ou un import massif, les transients périmés peuvent afficher de vieilles données pendant plusieurs heures, voire jours. La commande vide tout d'un coup :

  • `wp transient delete --all`
  • Variante : `wp transient delete --expired` pour ne supprimer que les transients déjà expirés (moins agressif, utile sur un site avec beaucoup d'objets en cache).

3. wp plugin deactivate --all : isoler un bug en 30 secondes

Quand une mise à jour WordPress casse le site et qu'on ne sait pas quel plugin est responsable, la méthode dichotomique manuelle prend une demi-heure. WP-CLI règle ça en quelques minutes. On désactive tout, on confirme que le site fonctionne, puis on réactive plugin par plugin jusqu'à retrouver le coupable.

  • `wp plugin deactivate --all` pour désactiver toute la pile
  • `wp plugin activate woocommerce` pour réactiver un plugin spécifique
  • `wp plugin list --status=active --field=name` pour lister rapidement ce qui tourne

4. wp db export : un dump qui ne plante pas en production

Sur un gros site WooCommerce, un mysqldump classique peut faire tomber les performances pendant l'export. WP-CLI propose une syntaxe plus maîtrisable, avec compression et exclusion de tables :

  • `wp db export backup-2026-05-26.sql --add-drop-table` pour un export complet
  • `wp db export --exclude_tables=wp_options,wp_postmeta backup-partial.sql` pour exclure les grosses tables et accélérer
  • `wp db export - | gzip > backup.sql.gz` pour piper directement vers gzip si on est court en disque

Sur les plans d'hébergement Pro et Business, nos sauvegardes automatisées passent par ce type de pipeline, avec rotation différenciée et test mensuel de restauration. Voir notre offre hébergement WordPress pour le détail des rétentions par plan (7 j sur Starter, 30 j sur Pro, 60 j sur Business).

5. wp debug : tracer une erreur sans toucher au code

Activer WP_DEBUG en éditant wp-config.php sur un site en production reste une mauvaise idée : ça affiche des messages d'erreur aux visiteurs si quelqu'un oublie de remettre la valeur à false. WP-CLI permet de manipuler les constantes proprement et en local seulement :

  • `wp config set WP_DEBUG true --raw` pour activer temporairement le debug
  • `wp config set WP_DEBUG_LOG true --raw` pour logger plutôt que afficher
  • `wp config delete WP_DEBUG` pour retirer la constante quand l'investigation est terminée

Notre check-list debug post-incident chez WPHelp247 fait toujours appel à ces trois lignes. Couplées à `wp cron event list` (pour voir les tâches planifiées qui s'exécutent ou pas) et à `wp option get siteurl` (pour vérifier que les URL n'ont pas dérivé), on a 80 % du diagnostic en quelques minutes.

Aller plus loin

Ces cinq commandes couvrent la grande majorité des opérations courantes. Pour les chantiers plus lourds (refonte d'architecture, audit complet, migration depuis une autre stack), notre studio sœur WPCraft prend le relais : voir leur page audit WordPress ou leur méthode sur creation-site-wordpress/refonte.

Si vous voulez externaliser ce type d'interventions au coup par coup, nos packs d'heures WPHelp247 permettent d'acheter de l'expert au compteur sans engagement. Pour une couverture maintenance régulière, voir nos bundles tout-inclus qui combinent hébergement et heures mensuelles.