Comment utiliser WordPress CLI
John Turner
John Turner
Avez-vous déjà cliqué à travers des menus interminables dans le tableau de bord WordPress juste pour mettre à jour un ou deux plugins ?
Ou peut-être avez-vous passé un temps précieux à sauvegarder manuellement votre site, en souhaitant qu'il existe un moyen plus rapide ? Il existe !
WP-CLI est un outil puissant qui vous permet de gérer votre site WordPress directement depuis la ligne de commande. Considérez-le comme un panneau de contrôle secret où vous pouvez faire à peu près tout sans vous connecter à l'espace d'administration de WordPress.
Apprendre WP-CLI peut sembler intimidant au début. Mais croyez-moi, c'est un changement de jeu. Il accélère votre flux de travail, automatise les tâches répétitives et vous donne plus de contrôle sur votre site.
Ce tutoriel vous montrera comment installer, comprendre et utiliser WP-CLI efficacement.
Voici les points clés à retenir :
- WP-CLI est une interface en ligne de commande qui vous permet de gérer WordPress sans le tableau de bord, économisant un temps considérable sur les tâches routinières.
- L'installation nécessite PHP 5.6+, un accès SSH et quelques commandes de terminal pour télécharger et configurer l'outil.
- Vous pouvez utiliser WP-CLI pour effectuer des tâches essentielles, notamment la mise à jour de WordPress, la sauvegarde de sites, la gestion de plugins/thèmes et le dépannage d'erreurs.
- Des commandes comme
wp core updateetwp plugin update --allgèrent les mises à jour instantanément sur l'ensemble de votre site. - WP-CLI permet une automatisation puissante grâce aux scripts bash, vous permettant de gérer plusieurs sites simultanément.
- L'outil est particulièrement précieux pour les développeurs, offrant un accès direct à la base de données, une fonctionnalité de recherche-remplacement et un échafaudage de thème enfant.
Table des matières
- Qu'est-ce que WordPress CLI ?
- Why Use WP-CLI?
- WP-CLI est-il installé par défaut ?
- Comment installer WP-CLI
- How to Use WordPress CLI
- 1. Mettre à jour WordPress
- 2. Récupérer les informations du site
- 3. Sauvegarder votre site
- 4. Gérer votre base de données
- 5. Gérer les plugins et les thèmes
- 6. Modérer les commentaires
- 7. Créer des articles et des pages
- 8. Créer et modifier des utilisateurs
- 9. Dépanner les erreurs
- 10. Créer un thème enfant
- 11. Régénérer les miniatures
- 12. Rechercher et remplacer des URL
- Frequently Asked Questions (FAQs)
Qu'est-ce que WordPress CLI ?
WordPress CLI, ou WP-CLI, est une interface en ligne de commande pour WordPress. Cela peut sembler technique, mais cela signifie simplement que vous pouvez interagir avec votre site WordPress en utilisant des commandes textuelles au lieu de cliquer sur des boutons dans le tableau de bord habituel.
Au lieu de vous connecter via un navigateur Web, vous utilisez un terminal ou une invite de commande sur votre ordinateur. Vous tapez des commandes, et WP-CLI les exécute, effectuant des actions telles que la mise à jour de plugins, la création d'utilisateurs ou la sauvegarde de votre base de données. C'est une manière différente de gérer votre site.
Essentiellement, WP-CLI vous permet de parler directement à WordPress en utilisant des commandes. Cette méthode est non seulement efficace, mais elle ouvre également de nouvelles possibilités d'automatisation et de gestion avancée.
Les développeurs adorent WP-CLI car il leur permet de gérer et de modifier rapidement les sites WordPress. Vous tapez des commandes précises qui peuvent mettre à jour, configurer et dépanner votre site Web en quelques secondes.
Pourquoi utiliser WP-CLI ?
WP-CLI peut révolutionner votre façon de travailler avec les sites WordPress.
Vitesse
La vitesse est le premier avantage majeur. Les tâches manuelles qui consomment des heures peuvent être accomplies en quelques minutes, voire quelques secondes.
Mettre à jour 20 plugins ? C'est une seule commande. Créer plusieurs comptes utilisateurs ? Une autre ligne de texte rapide.
Automatisation
L'automatisation devient facile avec WP-CLI.
Les tâches répétitives peuvent être scriptées et planifiées. Vous pouvez créer des scripts bash qui gèrent plusieurs sites WordPress simultanément, réduisant considérablement la charge de travail.
Les capacités de scripting signifient que vous pouvez intégrer la gestion de WordPress dans des flux de travail d'automatisation plus importants. Combinez WP-CLI avec d'autres outils comme Git, Ansible ou des scripts personnalisés pour une gestion complète du site.
Contrôle
Pour les développeurs, WP-CLI offre un contrôle sans précédent. Vous souhaitez installer rapidement un plugin, créer un thème enfant ou effectuer des opérations complexes sur la base de données ? Cela devient des tâches simples en ligne de commande.
Le débogage devient plus accessible. Vous pouvez récupérer des informations sur le site, vérifier la compatibilité des plugins et diagnostiquer les problèmes sans naviguer dans plusieurs écrans d'administration WordPress.
La gestion à distance est un autre avantage puissant. Vous pouvez gérer des installations WordPress sans avoir besoin d'un accès graphique direct. Une connexion en ligne de commande est tout ce dont vous avez besoin.
WP-CLI est-il installé par défaut ?
Non, WP-CLI n'est pas préinstallé avec WordPress.
Même si vous avez un site WordPress fonctionnant sur votre serveur, vous devrez prendre des mesures supplémentaires pour configurer WP-CLI. C'est un outil distinct qui nécessite une installation manuelle.
WP-CLI ne fait pas partie des fichiers de base de WordPress ni des panneaux de contrôle d'hébergement typiques. Vous devrez l'installer manuellement sur votre serveur.
La plupart des environnements d'hébergement web prennent en charge WP-CLI, mais il est toujours bon de vérifier auprès de votre fournisseur d'hébergement pour confirmer la compatibilité et obtenir des instructions d'installation spécifiques.
Comment installer WP-CLI
Pour installer WP-CLI, assurez-vous que votre serveur répond aux exigences. Vous aurez besoin de :
- PHP 5.6 ou supérieur : WP-CLI est une application PHP, assurez-vous donc d'avoir une version PHP compatible installée.
- Accès SSH : Vous aurez besoin d'un accès à la ligne de commande de votre serveur via SSH pour exécuter les commandes d'installation. La plupart des fournisseurs d'hébergement fournissent un accès SSH.
Ensuite, ouvrez le terminal, PuTTY ou Ubuntu. Cela dépend du système d'exploitation de votre ordinateur.
Dans la ligne de commande, connectez-vous à votre serveur avec cette commande :
ssh username@hostname
Ensuite, téléchargez la version Phar pour installer et gérer le CLI de WordPress :
curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
Vérifiez si le fichier a été téléchargé :
php wp-cli.phar --info
Enfin, vous devrez rendre ce fichier exécutable. C'est aussi le moment de le placer dans votre PATH. Utilisez cette commande :
chmod +x wp-cli.phar
sudo mv wp-cli.phar /usr/local/bin/wp
Après cela, WP-CLI devrait être installé ! Exécutez cette commande pour le vérifier :
wp --info
Si tout fonctionne correctement, vous verrez une sortie qui ressemble à ceci :
OS: Linux 4.10.0-42-generic #46~16.04.1-Ubuntu SMP Mon Dec 4 15:57:59 UTC 2017 x86_64
Shell: /usr/bin/zsh
PHP binary: /usr/bin/php
PHP version: 7.1.12-1+ubuntu16.04.1+deb.sury.org+1
php.ini used: /etc/php/7.1/cli/php.ini
MySQL binary:
MySQL version:
SQL modes:
WP-CLI root dir: /home/wp-cli/.wp-cli
WP-CLI packages dir: /home/wp-cli/.wp-cli/packages/
WP-CLI global config: /home/wp-cli/.wp-cli/config.yml
WP-CLI project config:
WP-CLI version: 1.5.0
Comment utiliser WordPress CLI
Maintenant que vous avez installé WP-CLI, explorons quelques façons pratiques de l'utiliser. Voici un bref aperçu :
- Mettre à jour WordPress : Gardez votre cœur, vos plugins et vos thèmes à jour avec des commandes uniques
- Récupérer les informations du site : Accédez instantanément aux numéros de version, URL, paramètres et détails des utilisateurs
- Sauvegarder votre site : Exporter les bases de données et créer des sauvegardes complètes à l'aide des commandes WP-CLI de Duplicator
- Gérer votre base de données : Optimiser, réparer, exporter et importer des fichiers de base de données
- Gérer les plugins et les thèmes : Installer, activer, désactiver, mettre à jour et désinstaller en masse
- Modérer les commentaires : Lister, approuver, marquer comme spam, mettre à la corbeille ou supprimer les commentaires avec des filtres
- Créer des articles et des pages : Générer et mettre à jour du contenu avec des champs personnalisés depuis la ligne de commande
- Créer et modifier des utilisateurs : Ajouter des utilisateurs, mettre à jour les rôles, réinitialiser les mots de passe et gérer les autorisations
- Dépanner les erreurs : Vérifier les fichiers du cœur, désactiver les plugins, changer de thème et vérifier les bases de données
- Créer un thème enfant : Créer la structure des thèmes enfants avec la structure et les fichiers appropriés
- Régénérer les miniatures : Reconstruire les miniatures d'images après avoir modifié les paramètres de taille
- Rechercher et remplacer des URL : Mettre à jour les URL dans votre base de données pour les migrations et les changements de domaine
1. Mettre à jour WordPress
Garder votre site WordPress à jour est crucial pour la sécurité et les performances. WP-CLI facilite les tâches administratives comme les sauvegardes.
Pour mettre à jour votre installation WordPress vers la dernière version, utilisez cette commande :
wp core update
Pour mettre à jour les plugins avec WP-CLI, utilisez :
wp plugin update --all
Pour mettre à jour un plugin spécifique, utilisez son slug :
wp plugin update plugin-slug
La mise à jour des thèmes fonctionne de la même manière.
wp theme update --all
wp theme update theme-slug
Vous pouvez également mettre à jour vers une version spécifique si nécessaire. Par exemple, pour mettre à jour vers WordPress 6.4.3, vous utiliseriez :
wp core update --version=6.4.3
Pour prévisualiser les mises à jour qui se produiraient sans réellement apporter de modifications, utilisez l'indicateur --dry-run :
wp core update --dry-run
Cette commande vous montrera quelles mises à jour sont disponibles sans les appliquer. C'est une bonne façon de tester avant de faire la mise à jour réelle.
2. Récupérer les informations du site
WP-CLI vous permet de récupérer rapidement diverses informations sur votre site WordPress. Cela peut être utile pour le débogage, la vérification des configurations ou simplement pour mieux comprendre votre configuration.
Pour voir la version actuelle de votre installation WordPress, utilisez :
wp core version
Cela affichera le numéro de version, comme 6.4.3.
Pour récupérer l'URL principale de votre site WordPress, utilisez :
wp option get home
Cela renverra l'URL configurée dans vos paramètres WordPress.
Pour trouver un e-mail d'administrateur, utilisez :
wp option get admin_email
Pour trouver le titre de votre site web, utilisez :
wp option get blogname
Vous pouvez obtenir une liste d'utilisateurs en utilisant :
wp user list
Vous pouvez obtenir les détails d'un utilisateur spécifique en utilisant son ID utilisateur. Par exemple, pour l'ID utilisateur 1 :
wp user get 1
Ces commandes sont utiles pour accéder rapidement aux détails importants de votre site WordPress sans vous connecter au tableau de bord. Vous pouvez également utiliser ces informations dans des scripts pour automatiser certaines tâches.
3. Sauvegarder votre site
Des sauvegardes régulières sont essentielles pour tout site WordPress. WP-CLI peut vous aider à créer des sauvegardes rapidement et facilement.
La sauvegarde la plus simple que vous puissiez effectuer avec WP-CLI est une exportation de base de données. Vous pouvez utiliser cette commande :
wp db export
Cependant, les sauvegardes complètes deviennent un peu plus compliquées.
Pour les simplifier, utilisez Duplicator. Ce plugin de sauvegarde est fourni avec des commandes WP-CLI afin que vous puissiez sauvegarder votre site sans quitter votre interface de ligne de commande WordPress.

Utilisez cette commande pour créer une sauvegarde complète du site (base de données et fichiers) :
wp duplicator build
Les commandes WP-CLI de Duplicator Pro sont hautement personnalisables. Voici quelques options :
--template=<ID>: Utilisez un modèle de sauvegarde prédéfini.--dir=<path>: Spécifier un emplacement de sauvegarde personnalisé.--delete:Supprimez automatiquement la sauvegarde après sa création.--phpsqldump,--phpzip,--duparchive: Changer le moteur d'archivage utilisé pour les sauvegardes.
Utilisez la commande wp duplicator build --help pour un aperçu complet des options disponibles.
Ces commandes offrent un moyen simple de créer, gérer et nettoyer vos sauvegardes. Vous pouvez automatiser les sauvegardes en créant des scripts simples qui exécutent ces commandes WP-CLI.
Par exemple, vous pourriez créer un script bash pour sauvegarder plusieurs sites simultanément.
#!/bin/bash
# Define site path to user associations
declare -A site_configs=(
["/var/www/site1/public"]="user1"
["/var/www/site2/public"]="user2"
["/var/www/site3/public"]="user3"
# Add more associations as needed
)
target_path="/path/to/backup/destination"
# Create and clean the destination folder
mkdir -p "$target_path" || { echo "Unable to create folder $target_path"; exit 1; }
cd "$target_path" || { echo "Unable to access folder $target_path"; exit 1; }
# Iterate through site path to user associations
for site_path in "${!site_configs[@]}"; do
user="${site_configs[$site_path]}"
# Check if the web folder exists
if [ ! -d "$site_path" ]; then
echo "Folder $site_path does not exist. Skipping..."
continue
fi
# Execute backup
cd "$site_path" || { echo "Unable to access $site_path"; continue; }
echo "Creating backup for $site_path with user $user"
sudo -u "$user" wp duplicator build --delete --dir="$target_path"
done
# Change ownership and create zip
cd "$target_path" || { echo "Unable to access $target_path"; exit 1; }
chown $USER:$USER *
zip ../backups.zip *
WP-CLI peut gérer des sauvegardes de base de données simples. Pour des sauvegardes plus flexibles et automatisées, installez Duplicator Pro. Ses commandes étendent WP-CLI, ce qui en fait un outil puissant pour votre stratégie de sauvegarde.
4. Gérer votre base de données
WP-CLI offre plusieurs commandes pour gérer votre base de données WordPress directement depuis la ligne de commande. Cela peut être utile pour optimiser les performances, résoudre les problèmes et effectuer des tâches de maintenance.
Pour optimiser votre base de données, utilisez :
wp db optimize
Cette commande permet d'améliorer les performances de la base de données en supprimant la surcharge. Il est conseillé de l'exécuter régulièrement.
Si vous rencontrez des problèmes avec votre base de données, vous pouvez essayer de la réparer en utilisant :
wp db repair
Cette commande tente de réparer les tables corrompues.
Vous avez déjà vu une commande d'exportation de base de données basique, mais voici un autre exemple. Vous pouvez exporter la base de données avec un nom de fichier personnalisé :
wp db export my_database_backup.sql
Pour importer une base de données précédemment exportée, utilisez :
wp db import my_database_backup.sql
Assurez-vous que le fichier SQL existe dans le répertoire où vous exécutez la commande.
Cette commande remplacera votre base de données existante par celle du fichier spécifié. Soyez prudent lorsque vous exécutez cette commande sur un site Web en direct. Sauvegardez-le toujours d'abord !
Ces commandes facilitent la gestion et la maintenance de votre base de données WordPress, sans avoir besoin de vous connecter à phpMyAdmin ou à un autre outil de gestion de base de données. Elles vous donnent un accès direct aux opérations de base de données via la ligne de commande.
5. Gérer les plugins et les thèmes
WP-CLI offre un moyen pratique de gérer vos plugins et thèmes WordPress depuis la ligne de commande. C'est beaucoup plus rapide que d'utiliser l'interface d'administration de WordPress, surtout si vous devez gérer plusieurs plugins et thèmes.
Pour installer un plugin, utilisez la commande suivante, en remplaçant plugin-slug par le slug réel du plugin :
wp plugin install plugin-slug
Par exemple, pour installer le populaire plugin All in One SEO :
wp plugin install all-in-one-seo-pack
Vous pouvez également installer un plugin à partir d'un fichier ZIP :
wp plugin install /path/to/plugin.zip
Pour activer un plugin, utilisez :
wp plugin activate plugin-slug
Par exemple, pour activer AIOSEO :
wp plugin activate all-in-one-seo-pack
Pour désactiver un plugin, utilisez :
wp plugin deactivate plugin-slug
Pour voir une liste de tous les plugins installés, utilisez :
wp plugin list
Vous pouvez également utiliser un indicateur pour filtrer par statut :
wp plugin list --status=active
Cela affichera une liste de vos plugins installés, y compris leur statut (actif ou inactif).
Pour désinstaller un plugin, utilisez :
wp plugin uninstall plugin-slug
Utilisez WP-CLI de manière similaire pour gérer les thèmes, en remplaçant « plugin » par « theme ». Par exemple, voici comment installer le thème Twenty Twenty-Four :
wp theme install twentytwentyfour
Ces commandes vous permettent de gérer efficacement vos plugins et thèmes. Vous pouvez effectuer des actions groupées, mettre à jour, activer ou désactiver des plugins et des thèmes avec une seule commande, vous faisant gagner un temps et des efforts précieux.
6. Modérer les commentaires
La gestion des commentaires peut être une tâche fastidieuse. WP-CLI offre un moyen rapide de modérer les commentaires depuis la ligne de commande. Ceci est particulièrement utile si vous avez un grand nombre de commentaires à traiter.
Pour voir une liste de tous les commentaires, utilisez :
wp comment list
Cette commande affichera une liste de tous les commentaires, ainsi que leur ID, auteur et statut. Vous pouvez utiliser divers indicateurs pour filtrer les commentaires.
Pour lister uniquement les commentaires en attente :
wp comment list --status=hold
Vous pouvez également lister les commentaires approuvés avec :
wp comment list --status=approve
Ou les commentaires de spam avec :
wp comment list --status=spam
Pour approuver un commentaire, utilisez son ID :
wp comment approve comment-id
Remplacez « comment-id » par l'ID réel du commentaire.
Pour désapprouver un commentaire, utilisez :
wp comment unapprove comment-id
Pour marquer un commentaire comme spam :
wp comment spam comment-id
Pour retirer le marquage de spam d'un commentaire :
wp comment unspam comment-id
Pour déplacer un commentaire dans la corbeille :
wp comment trash comment-id
Pour supprimer définitivement un commentaire :
wp comment delete comment-id
Soyez prudent, cette action est irréversible.
Vous pouvez effectuer des actions groupées en combinant des commandes avec des filtres. Par exemple, pour approuver tous les commentaires en attente :
wp comment list --status=hold --format=ids | xargs wp comment approve
Cette commande récupère les ID des commentaires en attente et les approuve tous en une seule étape.
Ces commandes facilitent grandement la gestion des commentaires, surtout si vous en recevez un grand volume. Vous pouvez rapidement filtrer, approuver, supprimer ou marquer les commentaires comme spam à l'aide de commandes simples.
7. Créer des articles et des pages
WP-CLI vous permet de créer et de gérer du contenu directement depuis la ligne de commande. Cela peut être utile pour ajouter rapidement des articles ou des pages.
Pour créer un nouvel article, utilisez :
wp post create --post_type=post --post_title="My New Post" --post_content="This is the content of my new post." --post_status=publish
Remplacez « Mon Nouvel Article » et « Ceci est le contenu de mon nouvel article. » par le titre et le contenu réels que vous souhaitez. Cette commande créera un nouvel article publié avec le titre et le contenu donnés.
Vous pouvez également définir le statut de l'article sur brouillon si vous ne souhaitez pas le publier immédiatement.
Pour créer une nouvelle page, utilisez :
wp post create --post_type=page --post_title="My New Page" --post_content="This is the content of my new page." --post_status=publish
Pour mettre à jour du contenu avec WP-CLI, vous aurez besoin de l'ID de l'article ou de la page :
wp post update post-id --post_title="Updated Title" --post_content="Updated Content."
Remplacez « post-id » par l'ID de l'article ou de la page que vous souhaitez mettre à jour et « Nouveau Titre » et « Nouveau Contenu » par le nouveau contenu.
Pour supprimer un article ou une page, utilisez l'ID :
wp post delete post-id
Pour lister vos articles :
wp post list --post_type=post
Pour lister vos pages :
wp post list --post_type=page
Vous pouvez utiliser divers indicateurs pour filtrer la liste par statut, auteur, et plus encore.
Vous pouvez également définir des champs personnalisés à l'aide de WP-CLI. Par exemple :
wp post meta set post-id meta-key "Meta Value"
Remplacez post-id, meta-key et Meta Value par les valeurs réelles.
Ces commandes offrent un moyen rapide d'ajouter, de mettre à jour ou de supprimer du contenu sans vous connecter à l'espace d'administration de WordPress. Cela peut être très utile lorsque vous souhaitez automatiser les tâches de gestion de contenu.
8. Créer et modifier des utilisateurs
Vous pouvez créer, mettre à jour et supprimer des utilisateurs avec WP-CLI.
Pour créer un nouvel utilisateur, utilisez cette commande :
wp user create username user@example.com --user_pass="password" --role=author
Remplacez username, user@example.com, password et author par les valeurs souhaitées.
Cette commande créera un nouvel utilisateur avec le nom d'utilisateur, l'e-mail, le mot de passe et le rôle spécifiés. Vous pouvez utiliser d'autres rôles, tels que éditeur, administrateur, abonné, et plus encore.
Pour voir une liste de tous les utilisateurs de votre site :
wp user list
Cela affichera une liste de tous les utilisateurs, ainsi que leurs identifiants, noms d'utilisateur et e-mails.
Pour obtenir les détails d'un utilisateur spécifique, utilisez :
wp user get user-id
Remplacez user-id par l'identifiant de l'utilisateur.
Pour mettre à jour un utilisateur existant, vous pouvez utiliser la commande wp user update. Par exemple, pour changer l'adresse e-mail de l'utilisateur :
wp user update user-id --user_email=newemail@example.com
Vous pouvez également mettre à jour d'autres champs tels que le mot de passe ou le rôle de l'utilisateur.
Pour réinitialiser le mot de passe d'un utilisateur, utilisez :
wp user update user-id --user_pass=new_password
Pour supprimer un utilisateur :
wp user delete user-id
Vous pouvez gérer les rôles et les capacités des utilisateurs à l'aide de WP-CLI. Par exemple, ajoutez le rôle d'éditeur à un utilisateur avec cette commande :
wp user set-role user-id editor
Utilisez wp user remove-role pour retirer un utilisateur d'un rôle.
Vous disposez maintenant de tous les outils nécessaires pour gérer les utilisateurs de votre site WordPress depuis la ligne de commande. Cela peut être particulièrement utile lorsque vous devez effectuer des actions groupées sur les utilisateurs.
9. Dépanner les erreurs
WP-CLI peut être un outil utile pour dépanner des erreurs et déboguer des problèmes sur votre site WordPress. Voici quelques commandes qui peuvent vous aider.
WP-CLI peut vous indiquer s'il y a des erreurs dans votre configuration WordPress. Cette commande vérifiera si tous les fichiers principaux de WordPress sont intacts. Si un fichier est manquant ou modifié, elle signalera une erreur.
wp core verify-checksums
Bien que WP-CLI ne puisse pas identifier directement les erreurs dans les plugins ou les thèmes, vous pouvez l'utiliser pour désactiver des plugins ou changer de thème pour le dépannage.
Pour désactiver tous les plugins :
wp plugin deactivate --all
Pour passer à un thème par défaut :
wp theme activate twentytwentyfour
Après cela, vous pouvez les réactiver un par un pour isoler l'erreur.
Vous pouvez utiliser la commande wp db check pour vérifier les erreurs de base de données, qui peuvent indiquer des problèmes sur votre site :
wp db check
Vous pouvez utiliser les commandes mentionnées dans la section de gestion de base de données pour réparer votre base de données si nécessaire.
WP-CLI n'interagit pas directement avec les journaux du serveur. Pour voir les journaux d'erreurs de votre serveur web, vous devez généralement utiliser des outils en ligne de commande tels que tail pour afficher directement les journaux d'erreurs de votre serveur web. L'emplacement de ces journaux varie en fonction de la configuration de votre serveur.
En utilisant WP-CLI, vous pouvez rapidement tester et diagnostiquer les problèmes potentiels pour remettre votre site en ligne rapidement.
10. Créer un thème enfant
Créer un thème enfant est une bonne idée lorsque vous souhaitez personnaliser votre thème WordPress sans modifier les fichiers du thème d'origine. WP-CLI rend ce processus simple et rapide.
Pour créer un thème enfant, utilisez la commande wp scaffold child-theme suivie du slug du thème parent.
Par exemple, pour créer un thème enfant pour le thème Twenty Twenty-Four, utilisez :
wp scaffold child-theme twentytwentyfour
Cette commande créera un nouveau répertoire pour votre thème enfant avec les fichiers de base nécessaires, y compris style.css et functions.php. Elle ajoutera également les informations d'en-tête nécessaires à style.css pour en faire un thème enfant valide.
Vous pouvez personnaliser le répertoire du thème enfant en ajoutant le drapeau --theme_slug.
wp scaffold child-theme twentytwentyfour --theme_slug=my-child-theme
Vous pouvez également spécifier le nom du thème enfant avec --theme_name.
wp scaffold child-theme twentytwentyfour --theme_name="My Child Theme"
Trouvez la liste complète des options avec :
wp help scaffold child-theme
Cette commande facilite grandement la création de thèmes enfants, qui gardent vos personnalisations organisées et garantissent qu'elles ne seront pas écrasées lors de la mise à jour du thème parent.
11. Régénérer les miniatures
Lorsque vous modifiez les tailles d'image dans les paramètres de WordPress, vous devez souvent régénérer les miniatures de vos images existantes. C'est une tâche courante que WP-CLI peut effectuer efficacement.
Pour régénérer toutes les miniatures, utilisez :
wp media regenerate
Cette commande parcourra tous vos fichiers multimédias existants et régénérera les miniatures en fonction de vos paramètres actuels. Cela peut prendre un certain temps en fonction du nombre d'images que vous avez.
Vous pouvez également régénérer les miniatures pour des images spécifiques ou certaines tailles. Consultez la liste complète des drapeaux disponibles en utilisant :
wp help media regenerate
12. Rechercher et remplacer des URL
La fonctionnalité de recherche et remplacement de WP-CLI est extrêmement utile lorsque vous migrez un site WordPress. Elle vous aidera à mettre à jour les URL après un changement de domaine.
Pour rechercher une ancienne URL et la remplacer par une nouvelle URL, utilisez la commande suivante :
wp search-replace 'oldurl.com' 'newurl.com'
Remplacez « ancienneurl.com » par l'URL de votre site précédent et « nouvelleurl.com » par l'URL de votre nouveau site.
Cette commande recherchera dans toute votre base de données et remplacera toutes les occurrences de l'ancienne URL par la nouvelle.
Sauvegardez toujours votre base de données avant d'exécuter cette commande. Cela garantit que vous pouvez facilement revenir à l'état précédent en cas de problème.
Soyez très précis avec les anciennes et nouvelles URL. Même une petite faute de frappe peut causer des problèmes.
Cette commande peut être puissante, mais elle est aussi très dangereuse si elle est utilisée incorrectement. Testez sur un site de staging avant de l'implémenter en production.
Si vous utilisez des données sérialisées dans votre base de données (ce qui est très courant), utilisez le drapeau --all-tables pour vous assurer que toutes les occurrences des URL sont modifiées. Par exemple :
wp search-replace 'oldurl.com' 'newurl.com' --all-tables
Pour prévisualiser les modifications sans les effectuer réellement, utilisez le drapeau --dry-run :
wp search-replace 'oldurl.com' 'newurl.com' --dry-run
Cette commande vous montrera une liste de toutes les modifications qu'elle effectuerait, vous donnant ainsi la possibilité de les vérifier avant de continuer.
Questions fréquemment posées (FAQ)
WP CLI fonctionne-t-il sous Windows ?
WP-CLI fonctionne sous Windows avec l'aide d'outils tels que WSL (Windows Subsystem for Linux) ou via des environnements PHP pris en charge. Une installation directe est possible, mais des problèmes de compatibilité peuvent survenir sans une configuration appropriée.
Comment enregistrer une commande WP CLI ?
Enregistrez une commande WP-CLI en utilisant la fonction WP_CLI::add_command dans votre code PHP. Définissez une fonction de rappel pour le comportement de la commande et incluez-la dans la base de code de votre plugin ou thème. Documentez correctement les arguments et l'utilisation pour garantir la fonctionnalité.
Comment vérifier si CLI est installé ou non ?
Vérifiez si WP-CLI est installé en ouvrant un terminal et en exécutant la commande . S'il est installé, le numéro de version ou le chemin s'affichera ; sinon, un message d'erreur apparaîtra.wp --info
Comment utiliser WordPress CLI en tant que débutant ?
Commencez à utiliser WordPress CLI en installant WP-CLI et en naviguant vers votre répertoire WordPress dans la ligne de commande. Exécutez des commandes comme wp plugin list pour afficher les plugins ou wp theme activate pour changer de thème. Commencez par des commandes de base et consultez la documentation WP-CLI pour obtenir des conseils.
Réflexions finales
WP-CLI est un outil puissant qui peut améliorer considérablement votre flux de travail de gestion WordPress. Des mises à jour simples aux opérations de base de données complexes, il offre un moyen plus rapide et plus efficace d'interagir avec vos sites WordPress.
Nous vous encourageons à commencer à expérimenter avec WP-CLI dès aujourd'hui. Commencez par quelques commandes de base de ce tutoriel WP-CLI et explorez progressivement ses fonctionnalités plus avancées.
Plus vous l'utiliserez, plus vous serez à l'aise et plus vous réaliserez son potentiel !
Si vous recherchez une flexibilité supplémentaire dans WP-CLI, envisagez d'utiliser Duplicator Pro. C'est un outil de sauvegarde qui s'intègre de manière transparente avec WP-CLI, rationalisant vos sauvegardes de site depuis la ligne de commande.
Pendant que vous êtes ici, je pense que vous aimerez ces tutoriels WordPress supplémentaires :
- Codez plus intelligemment, pas plus dur : outils de développement WordPress pour tous les professionnels
- Comment un développeur migre facilement des boutiques en ligne avec 150 000 produits
- Comment installer WordPress sur Docker pour accélérer votre développement
- 9 meilleurs outils pour gérer plusieurs sites WordPress
- Comment annuler les modifications dans WordPress (5 méthodes)