Wordpress WP-CLI
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
Lire plus