Le WordPress Cli (ou WP-CLI) est un outil en ligne de commande pour la gestion des sites web WordPress par la ligne de commande. Dans ce tutoriel, vous apprendrez:
- Ce qu’est le WP-CLI,
- comment installer WP-Cli en utilisant Docker et
- Aperçu des commandes de base de cet outil.
WP-CLI sera particulièrement utile si vous êtes un développeur WordPress, un administrateur système ou si vous dirigez une entreprise construite autour de WordPress. Cet outil en ligne de commande vous aidera grandement à faire plus en moins de temps. Par exemple, la prise de copies de sauvegarde, la mise à jour de WordPress et des plugins, la publication de contenu et l’interrogation de bases de données peuvent être réalisées relativement rapidement. Par exemple, vous pouvez utiliser ce plugin pour installer automatiquement Woocommerce dans WordPress.
Sommaire:
Exigences du WP-Cli
- Accès SSH à votre serveur
- PHP 5.3.2 ou version ultérieure.
- WordPress 3.4 ou version ultérieure.
- Un environnement UNIX comme Linux.
Installer WP-Cli
Vous pouvez soit 1) installer directement WP-Cli sur votre système ou l’installer en utilisant Docker.
Installer directement sur votre système
# 1/ Télécharger wp-cli
curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
# 2/ Rendre l'application exécutable
chmod +x wp-cli.phar
# 3/ Déplacez-le dans /usr/local/bin/wp
sudo mv wp-cli.phar /usr/local/bin/wp
# Vérifier si l'installation a fonctionné
wp --info
Vous pouvez maintenant simplement taper “wp” dans votre terminal pour appeler WP-Cli. Au fait, n’oubliez pas de lancer wp depuis le répertoire racine de WordPress.
Installer WordPress en utilisant le docker-compose et WP-ClI
Voir notre précédent tutoriel pour installer et configurer automatiquement wordpress en utilisant docker-compose et WP-CLI.
Vous pouvez déployer automatiquement un site WordPress docker local en 5 minutes en utilisant les commandes suivantes:
# Téléchargez un exemple de docker-compose pour WordPress
git clone https://github.com/kassambara/wordpress-docker-compose
cd wordpress-docker-compose
# Installation automatique de wordpress
make autoinstall
Visitez votre site à l’adresse http://localhost et votre base de données via phpMyAdmin à l’adresse http://localhost:8080.
Identification par défaut de l’administrateur de votre site wordpress:
Username: wordpress
Password: wordpress
Identification par défaut de l’interface phpMyAdmin:
Username: root
Password: password
Cette installation comprend également l’outil WP-ClI. Dans les prochaines sections, nous utiliserons les commandes WP-ClI de docker-compose. Donc, commencez par créer un alias pour appeler simplement les commandes de composition du docker WP-CLI:
wp="docker-compose run --rm wpcli"
Les commandes WP-CLI les plus populaires
Commande | Description |
---|---|
wp cap | Ajoute, supprime et liste les capacités d’un rôle utilisateur. |
wp cli | Examine les informations actuelles du WP-CLI, vérifie les mises à jour ou affiche les alias définis. |
wp comment | Crée, met à jour, supprime et modère les commentaires. |
wp config | Génère et lit le fichier wp-config.php. |
wp core | Télécharge, installe, met à jour et gère une installation WordPress. |
wp cron | Teste, exécute et supprime les événements WP-Cron ; gère les horaires WP-Cron. |
wp db | Effectue les opérations de base de la base de données en utilisant les informations d’identification stockées dans wp-config.php. |
wp eval | Exécute un code PHP arbitraire. |
wp eval-file | Charge et exécute un fichier PHP. |
wp export | Exporte le contenu de WordPress vers un fichier WXR. |
wp i18n | Fournit des outils d’internationalisation pour les projets WordPress. |
wp import | Importe le contenu d’un fichier WXR donné. |
wp language | Installe, active et gère les packs de langues. |
wp maintenance-mode | Active, désactive ou vérifie l’état du mode de maintenance d’un site. |
wp media | Importe des fichiers en pièces jointes, régénère des vignettes ou liste les tailles d’images enregistrées. |
wp menu | Liste, crée, attribue et supprime les menus de navigation du thème actif. |
wp plugin | Gère les plugins, y compris les installations, les activations et les mises à jour. |
wp post | Gère les messages, le contenu et les méta. |
wp post-type | Récupère les détails sur les types de publications. |
wp rewrite | Liste ou supprime les règles de réécriture du site, met à jour la structure du permalien. |
wp role | Gère les rôles des utilisateurs, y compris la création de nouveaux rôles et la réinitialisation des valeurs par défaut. |
wp scaffold | Génère du code pour les types de messages, les taxonomies, les plugins, les child thèmes, etc. |
wp search-replace | Recherche/remplacement de textes dans la base de données. |
wp shell | Ouvre une console PHP interactive pour exécuter et tester le code PHP. |
sidebar wp | Listes des sidebars enregistrés. |
wp site | Crée, supprime, vide, modère et liste un ou plusieurs sites sur une installation multisite. |
wp super-admin | Liste, ajoute ou supprime les utilisateurs super-admin sur une installation multisite. |
wp taxonomy | Recherche d’informations sur les taxonomies enregistrées. |
wp term | Gère les termes de la taxonomie et les méta termes, avec les commandes de création, de suppression et de liste. |
wp theme | Gère les thèmes, y compris les installations, les activations et les mises à jour. |
wp user | Gère les utilisateurs, ainsi que leurs rôles, leurs capacités et leurs méta. |
wp widget | Gère les widgets, y compris l’ajout et le déplacement de ceux-ci dans les barres latérales. |
Mise à jour de WordPress
# Mise à jour vers la dernière version
$wp core update
# Revenir à une version plus ancienne
wp core update --version=4.9.6 --force
Commandes de plugins
Nom | Description |
---|---|
wp plugin activate | Active un ou plusieurs plugins. |
wp plugin deactivate | Désactive un ou plusieurs plugins. |
wp plugin delete | Supprime les fichiers de plugin sans les désactiver ou les désinstaller. |
wp plugin get | Obtention de détails sur un plugin installé. |
wp plugin install | Installe un ou plusieurs plugins. |
wp plugin is-active | Vérifie si un plugin donné est actif. |
wp plugin is-installed | Vérifie si un plugin donné est installé. |
Liste de plugins wp | Obtenir une liste de plugins. |
wp plugin path | Donne le chemin d’accès à un plugin ou au répertoire des plugins. |
wp plugin search | Recherche dans le répertoire des plugins de WordPress.org. |
wp plugin status | Révèle le statut d’un ou de tous les plugins. |
wp plugin toggle | Bascule l’état d’activation d’un plugin. |
wp plugin uninstall | Désinstallation d’un ou plusieurs plugins. |
wp plugin update | Mise à jour d’un ou plusieurs plugins. |
Liste des plugins
$wp plugin list
+---------+----------+--------+---------+ | nom | statut | mise à jour | version | +---------+----------+--------+---------+ | akismet | inactif | aucun | 4.1.3 | | hello | inactif | aucun | 1.7.2 | +---------+----------+--------+---------+
Supprimer le plugin
$wp plugin delete akismet hello
Installer et activer le plugin
# Installer et activer un nouveau plugin
$wp plugin install woocommerce --activate
# désactiver un plugin
$wp plugin deactivate woocommerce
# N'activez qu'un plugin
$wp plugin activate woocommerce
# Mise à jour des plugins
$wp plugin update woocommerce
$wp plugin update --all
If you want to install and activate multiple WordPress plugins at once, you can mention multiple plugins in the same command.
Version du plugin et détails
$wp plugin activate woocommerce
+-------------+-----------------------------------------------------------------+ | Champ | Valeur | +-------------+-----------------------------------------------------------------+ | nom | woocommerce | | titre | WooCommerce | | auteur | Automattic | | version | 3.8.1 | | description | Une boîte à outils pour le commerce électronique qui vous aide à vendre n'importe quoi. Magnifiquement. | | statut | actif | +-------------+-----------------------------------------------------------------+
Commandes de thème
Nom | Description |
---|---|
wp theme activate | Active un thème. |
Suppression d’un ou plusieurs thèmes. | |
wp theme disable | Désactive un thème sur une installation multi-sites WordPress. |
wp theme enable | Active un thème sur une installation multisite WordPress. |
wp theme get | Obtenir des détails sur un thème. |
wp theme install | Installe un ou plusieurs thèmes. |
wp theme is-active | Vérifie si un thème donné est actif. |
wp theme is-installed | Vérifie si un thème donné est installé. |
wp theme list | Obtenir une liste des thèmes. |
wp theme mod | Définit, obtient et supprime les mods de thèmes. |
wp theme path | Donne le chemin d’accès à un thème ou au répertoire des thèmes. |
wp theme search | Recherche dans le répertoire des thèmes de WordPress.org. |
wp theme status | Révèle le statut d’un ou de tous les thèmes. |
wp theme update | Mise à jour d’un ou plusieurs thèmes. |
Liste de thèmes
$wp theme list
+-----------------+----------+--------+---------+ | nom | statut | mise à jour | version | +-----------------+----------+--------+---------+ | twentynineteen | inactifs | aucun | 1,4 | | twentyseventeen | inactifs | aucun | 2,2 | | twentysixteen | inactifs | aucun | 2.0 | | twentytwenty | actifs | aucun | 1.1 | +-----------------+----------+--------+---------+
Activer un thème
$wp theme activate twentyseventeen
Mise à jour de thème
# Mise à jour d'un thème
$wp theme update twentyseventeen
# Mettre à jour tous les thèmes
$wp theme update --all
Rechercher et remplacer
Cette commande est particulièrement utile lorsque vous avez modifié l’URL du site ou même ajouté HTTPS à l’URL du site.
Faites d’abord un essai:
$wp search-replace {old URL} {new URL} --dry-run
La commande ci-dessus n’affichera le résultat escompté qu’une fois cette requête exécutée. Il s’agit d’une mesure de précaution pour s’assurer que le résultat sera conforme à l’attente. Une fois que vous êtes satisfait, vous pouvez procéder au remplacement effectif en retirant dry-run de la commande ci-dessus, comme suit:
$wp search-replace {old URL} {new URL}
Migration de contenu
wp db export
: Exporte la base de données vers un fichier ou vers STDOUT.wp db import
: Importe une base de données à partir d’un fichier ou de STDIN.
# Exporte toute la base de données vers un fichier dans le répertoire wordpress
$wp db export db.sql
# Exporter certains tableaux
$wp db export --tables=wp_options,wp_users
# Importer une base de données
$wp db import db.sql
Il migre efficacement toutes les données et informations, y compris les messages, les liens, les dates, les auteurs, les commentaires, etc., et correspond en conséquence aux taxonomies WordPress existantes.
Commandes supplémentaires de gestion de la base de données:
Nom | Description |
---|---|
wp db check | Vérifie l’état actuel de la base de données. |
wp db clean | Supprime toutes les tables avec $table_prefix de la base de données. |
wp db cli | Ouvre une console MySQL en utilisant les informations d’identification de wp-config.php |
wp db columns | Affiche des informations sur une table donnée. |
wp db create | Crée une nouvelle base de données. |
wp db drop | Supprime la base de données existante. |
wp db export | Exporte la base de données vers un fichier ou vers STDOUT. |
wp db import | Importe une base de données à partir d’un fichier ou de STDIN. |
wp db optimize | Optimise la base de données. |
wp db prefix | Affiche le préfixe de la table de la base de données. |
wp db query | Exécute une requête SQL sur la base de données. |
wp db repair | Réparation de la base de données. |
wp db reset | Supprime toutes les tables de la base de données. |
wp db search | Trouve un texte dans la base de données. |
wp db size | Affiche le nom et la taille de la base de données. |
wp db tables | Liste des tables de la base de données. |
Gérer les utilisateurs
# Liste des identifiants d'utilisateurs
$wp user list
# Créer un nouvel utilisateur.
$wp user create bob bob@example.com --role=author
# Mettre à jour un utilisateur existant.
$wp user update 123 --display_name=Mary --user_pass=marypass
# Supprimer l'utilisateur 123 et réassigner les postes à l'utilisateur 567
$ wp user delete 123 --reassign=567
Version: English
No Comments