# WP-CLI en 2025 : les nouveautés des dernières versions à connaître

> Ce qui a changé dans les dernières versions de WP-CLI, les commandes et options ajoutées récemment, et comment elles s'intègrent dans nos scripts existants.

- Auteur : Clément Hadrot
- Publié le : 2025-01-17
- Mis à jour le : 2025-01-17
- Catégorie : Outils &amp; workflow
- URL : https://wpmoderne.dev.wordpress-developpement.fr/outils/wp-cli-nouveautes-2025/

## L’essentiel

- Le support PHP suit désormais de plus près les versions récentes
- Plusieurs commandes ont gagné des options de sortie plus précises
- Les paquets tiers restent le principal vecteur de nouvelles fonctionnalités

WP-CLI a la particularité de changer peu en apparence — les commandes de base, `wp post`, `wp option`, `wp plugin`, n'ont pas bougé depuis des années — mais d'accumuler discrètement des améliorations à chaque version mineure : nouvelles options de filtrage, meilleure gestion des formats de sortie, compatibilité PHP à jour. Nous tenons à jour une liste interne des changements qui affectent réellement nos scripts de maintenance, plutôt que de tout relire dans le journal des modifications à chaque mise à jour.

Voici ce qui, sur les dernières versions, a changé nos habitudes ou mérite d'être intégré aux scripts existants.

## Suivre le rythme des versions de PHP

WP-CLI publie ses versions stables en cohérence avec le cycle de PHP pris en charge par le cœur de WordPress. Sur un parc de serveurs qui migre progressivement vers des versions de PHP plus récentes, il est important de vérifier la compatibilité annoncée de WP-CLI avant de monter la version de PHP d'un serveur qui héberge encore des scripts de maintenance automatisés :

```
wp cli info
wp cli check-update
```

La commande `wp cli check-update` compare la version installée à la dernière version stable disponible et signale si une mise à jour est recommandée, sans rien modifier automatiquement.

## Des options de sortie plus précises

Plusieurs commandes de base ont progressivement enrichi leurs options `--fields` et `--format`, ce qui simplifie l'intégration dans des scripts qui consomment la sortie de WP-CLI de façon structurée plutôt que de la parser en texte brut :

```
wp plugin list --status=active --fields=name,version,update --format=json
wp user list --role=administrator --fields=user_login,user_email --format=csv
```

Le format `json` reste le plus fiable à consommer depuis un script externe (avec `jq`, par exemple), plutôt que le format tableau, pensé pour la lecture humaine et sujet à changer de largeur de colonnes selon le contenu.

> L'essentiel à retenir : Le support PHP suit désormais de plus près les versions récentes ; Plusieurs commandes ont gagné des options de sortie plus précises ; Les paquets tiers restent le principal vecteur de nouvelles fonctionnalités

## wp config et la gestion des constantes

La commande `wp config` reste l'un des points d'entrée les plus utiles pour scripter la création d'un `wp-config.php` reproductible, en particulier lors du provisionnement automatisé de nouveaux environnements :

```
wp config create --dbname=exemple --dbuser=exemple --dbpass="${MOT_DE_PASSE}" --skip-check
wp config set WP_DEBUG true --raw --type=constant
wp config set WP_MEMORY_LIMIT 256M --type=constant
```

L'option `--type=constant` distingue explicitement une constante PHP d'une simple variable, ce qui évite une ambiguïté fréquente dans les scripts qui manipulent plusieurs types d'entrées dans `wp-config.php`.

## Les paquets tiers, principal moteur de nouveauté

La majorité des fonctionnalités réellement nouvelles n'arrivent pas dans le cœur de WP-CLI mais dans son écosystème de paquets installables séparément : `wp-cli/doctor-command`, `wp-cli/profile-command`, ou des paquets communautaires plus spécialisés. Un réflexe utile en début d'année : relister les paquets installés et vérifier s'ils ont reçu des mises à jour :

```
wp package list
wp package update wp-cli/doctor-command
```

## Attention à la dépréciation progressive du support de PHP ancien

À mesure que les versions stables de WP-CLI évoluent, la prise en charge des versions de PHP les plus anciennes finit par être retirée, comme c'est l'usage dans tout projet PHP actif. Sur un serveur mutualisé qui n'a pas été mis à jour depuis longtemps, cela peut se traduire par un blocage silencieux de la mise à jour de WP-CLI, ou par des avertissements de dépréciation bruyants dans la sortie des commandes. La vérification la plus sûre reste d'exécuter `wp cli info` après chaque changement de version de PHP sur un serveur, avant de relancer des scripts automatisés qui en dépendent.

- `wp cli info` affiche la version de PHP utilisée par WP-CLI, qui peut différer de celle du serveur web si plusieurs binaires PHP coexistent ;
- `wp cli check-update` signale une mise à jour disponible sans l'appliquer ;
- `wp cli update` applique la mise à jour, avec une option `--stable` pour rester sur les versions publiées officiellement.

> On ne met jamais à jour WP-CLI sur tout un parc de serveurs en une seule commande groupée. On teste d'abord sur un serveur non critique, on vérifie que les scripts de maintenance existants tournent toujours, puis seulement on généralise.

## Pour aller plus loin

Le journal des modifications publié sur le dépôt GitHub officiel de WP-CLI reste la référence la plus fiable pour suivre les changements version par version, bien plus précise qu'un résumé annuel. Mais pour une équipe qui maintient des dizaines de scripts basés sur WP-CLI, une revue régulière — même sommaire — des nouveautés évite de découvrir une option utile des mois après sa sortie, ou pire, de continuer à contourner manuellement un problème que la dernière version résout nativement.
