Fermer

novembre 6, 2018

Guide d'introduction à la gestion de WordPress avec WP-CLI –


Cet article fournit un guide d'introduction à WP-CLI, un outil de ligne de commande créé pour simplifier la vie des développeurs, leur permettant de gérer un site WordPress via la ligne de commande plutôt que via l'interface d'administration habituelle. [19659002] WP-CLI a été créé par Daniel Bachhuber il y a plus de dix ans. Depuis lors, il est devenu un outil indispensable dans tous les arsenaux de développeurs WordPress avancés – «déployé et utilisé par presque tous les principaux utilisateurs de WordPress», selon Matt Mullenweg . WP-CLI est l'outil officiel de CLI pour WordPress depuis 2016.

WP-CLI sert à installer et à configurer un site Web WordPress, à en modifier les options, à gérer les utilisateurs et à une foule d'autres choses. . Il peut être utilisé pour accélérer considérablement les flux de travail des développeurs.

WP-CLI se présente sous la forme d’un fichier phar – abréviation de PHP Archive. C’est une norme pour regrouper plusieurs fichiers PHP et d’autres ressources en une seule application, ce qui simplifie la distribution et l’installation.

Installation

WP-CLI suppose évidemment que nous avons accès au shell système. Ce sera assez simple sur les systèmes Linux et macOS – en particulier sur les serveurs – WordPress étant servi presque universellement à partir de machines Linux. Si nous avons un hébergement de serveur dédié, ou un hébergement en nuage comme AWS, Alibaba Cloud, etc., ou si nous utilisons un VPS de Digital Ocean, Vultr, Linode, etc., SSH est une option d’accès par défaut. les hôtes partagés offrent des options d'accès SSH. (Certains peuvent même venir avec WP-CLI préinstallé.)

Pour les utilisateurs de Windows, WP-CLI peut être installé via Composer mais nous recommandons aux lecteurs de se familiariser avec Windows Subsystem for Linux car il permet de disposer d'un environnement Linux natif, ainsi que de Bash, d'un gestionnaire de paquets tel que APT, etc. WordPress est une application PHP, et l'environnement natif de PHP est Linux.

D'autres exemples de code supposent que nous sommes utilisant Linux ou un système de type Unix.

Pour récupérer l'archive phar de WP-CLI, nous utilisons ecurl ou wget :

 curl -O https: // raw. githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar

Ceci télécharge nos archives dans le répertoire actuel. Ensuite, nous le rendons exécutable:

 chmod + x wp-cli.phar

Nous les déplaçons pour qu’il soit disponible en tant que commande wp :

 sudo mv wp-cli.phar / usr / local / bin / wp

Nous avons maintenant une commande wp disponible:

Maintenant, en tapant la commande wp elle affiche toutes les options et paramètres possibles. Une mise en garde: si nous sommes en tant qu'utilisateur root, nous devons ajouter - allow-root à nos commandes:

 Ajout de --allow-root pour permettre l'exécution en tant que root utilisateur

Maintenant que nous l'avons configuré, nous pouvons explorer les commandes et les scénarios d'utilisation possibles.

Commandes WP-CLI

WP-CLI vise à offrir une alternative rapide à l'administrateur Web WordPress. interface. Il existe des fragments de code ou de fonctionnalités qui offrent des interfaces simples et précises pour l'exécution de tâches complexes . Outre les commandes groupées, WP-CLI définit une API pour l'intégration de commandes tierces – WP_CLI :: add_command () . Celles-ci peuvent être distribuées sous forme de paquetages autonomes, ou dans le cadre de plugins ou de thèmes WordPress.

Dans ce guide, nous passerons en revue les commandes fournies – celles fournies avec l'installation par défaut de WP-CLI – et d'autres produits tiers plus remarquables.

Les commandes peuvent être des commandes de base à un argument, telles que wp somecommand ou des sous-commandes sous l’espace de noms des commandes de base, telles que wp, sous-commande .

wp core

La sous-commande wp core est une commande / un espace de noms composé de sucommands traitant du noyau WordPress – nous pouvons donc télécharger, installer, mettre à jour, convertir en multisite et obtenir des informations sur notre WordPress. version de base:

  • wp core télécharger téléchargera la dernière version de WordPress dans le répertoire actuel
  • wp core install exécute le processus d'installation standard de WordPress, avec des options telles que - url = somewebsite .com - title = SomeWebsite - admin_user = nom_utilisateur som - admin_password = nom_passe et - admin_email=some@email.com
  • wp core multisite-install installe une nouvelle installation WordPress multisite et wp core multisite-convert convertit une installation régulière en multisite.
  • La ​​mise à jour de wp core convertira une installation régulière en multisite. une nouvelle version, et wp core update-db mettra à jour la base de données.

Vous trouverez plus de détails sur wp core dans la documentation .

. ] WP-CLI brille vraiment lorsque nous combinons ses commandes dans des scripts Bash. Ainsi, nous pouvons combiner, par exemple, wp core download et wp core install en une seule commande Bash et rationaliser le l’installation.

Il est à noter qu’avant de lancer l’installation, nous devons créer un wp-config.php . fichier, avec les informations d'identification de la base de données et d'autres informations nécessaires à l'installation.

WP-CLI fournit une commande wp config create à cet effet.

wp config

wp config est un espace de noms pour les commandes relatives à la configuration WordPress.

  • La liste de configuration wp répertorie toutes les variables de configuration:

     Variables de configuration

  • wp config create – crée une configuration fichier avec les variables que nous fournissons, comme wp config create --dbname = somedb --dbuser = someuser --dbpass = somepass et d'autres variables, comme indiqué dans les documents

  • wp config get (par exemple, wp config get préfixe_table ) récupère des variables de configuration spécifiques à partir de wp-config.php

  • Le jeu de configuration wp définit également les variables de configuration

Plus de détails sur la wp peuvent être trouvés ici ici .

Le cap wp est intéressant pour l'administration des rôles et des capacités des utilisateurs. Nous pouvons ajouter et supprimer des capacités de rôles particuliers.

wp cron est un espace de noms de commande pour le test, l'exécution et la suppression d'événements WP-Cron. La liste des événements wp cron par exemple, nous donnerait un résultat ressemblant à ceci:

 wp cron output

Ensuite, nous pourrions supprimer des événements de type . wp cron event delete wsal_cleanup – ou les replanifier, etc.

Parfois, lors de la mise à jour du contenu, du développement, de la modification, nous constatons que l'actualisation d'une page WordPress n'indique pas les modifications apportées. Cela a souvent abouti à une recherche frénétique, à la recherche de ce que nous avions mal fait.

Il s’agit souvent d’un problème de cache. Le cache d'objets WordPress, par défaut, n'est pas persistant, de sorte que la nécessité de nettoyer le cache d'objets sera exacerbée par l'utilisation de plug-ins qui conservent le cache d'objets lors de requêtes (et c'est généralement le cas).

wp cache est un espace de noms contenant des commandes permettant de gérer le cache d'objets WP.

wp cache flush est une commande qui vide tout le cache. C'est une évidence – une commande simple et souvent utilisée qui ne nécessite aucun autre paramètre et qui purge tout du cache.

Le cache wp contient également d'autres commandes pouvant également être utilisées. utilisé pour la gestion très atomique des éléments de cache.

wp cache add wp cache delete wp cache get wp cache set Le remplacement du cache wp et d'autres commandes permettent de répertorier, inspecter, ajouter, modifier ou supprimer des valeurs spécifiques du cache d'objets.

Les transitoires WordPress sont un autre élément de la stratégie de mise en cache de WP, qui est persistante. par défaut, et peut jouer un rôle dans les performances globales de WordPress. Il n'est pas rare que de nombreux plugins utilisent généreusement les transitoires WordPress, ce qui peut être encombré et ralentir le site Web.

L'espace de noms wp transitoire contient des commandes permettant de supprimer, d'afficher ou de définir des transitoires.

Un autre élément WordPress permalinks .

wp rewrite - - dans le système de mise en cache de WordPress, qui nécessite parfois une purge, et a probablement provoqué des heures et des heures de confusion pour les débutants flush en particulier - permet de vider les règles de réécriture (permaliens). Nous pouvons également lister les règles de réécriture.

wp db contient des commandes permettant de gérer une base de données WordPress. Aperçu, réparation, optimisation, recherche, requêtes diverses. Nous pouvons également exporter ou importer la base de données.

wp eval et wp fichier-eval peut être utilisé pour exécuter du code dans le cadre de notre installation WordPress.

wp export et wp import exportation et importation du contenu au format WXR.

L'option wp contient des commandes permettant de gérer, de récupérer et de définir les options WordPress.

wp scaffold contient des commandes qui créent un code général pour les plugins, les thèmes, les thèmes enfants, les blocs Gutenberg, les types de publication, les taxonomies - raccourcissant ainsi le chemin pour les faire fonctionner.

wp search-replace effectue une recherche-remplacement sur une base de données avec des chaînes que nous fournissons comme arguments. Cela s'avère très pratique lorsque nous migrons la base de données d'un site Web vers un autre et que nous devons modifier les URL. Par exemple, lorsque nous créons un site Web intermédiaire ou que nous déplaçons une base de données vers un site Web de production.

WordPress sérialise les chaînes de contenu de la base de données. Ainsi, une recherche brute - remplacer sur une base de données dans un éditeur ne fonctionnerait pas; En fait, le site Web serait cassé.

wp shell est particulièrement intéressant, car il nous permet de saisir un remplaçant WordPress - un environnement de shell actif de notre installation WordPress. Là, nous avons un accès complet à tout ce qu’un plugin actif peut avoir à sa disposition. Nous pouvons écrire du code, charger du code à partir de fichiers, exécuter des fonctions, observer ou inspecter la sortie de fonctions. Il est très facile de tester le nouveau code sans cycles de rafraîchissement du navigateur.

wp user sert à gérer, mettre à jour, supprimer et modifier les rôles des utilisateurs.

Voici quelques-uns des paramètres par défaut, construits -dans les commandes. Une documentation détaillée de toutes les commandes est disponible dans les documents de développement de WordPress .

Le plugin wp permet de répertorier, installer, activer, désactiver et supprimer des plug-ins, ainsi que d’écrire des scripts. qui automatise l’installation de plusieurs plugins en masse. La liste des plug-ins wp pourrait nous donner une sortie ressemblant à ceci:

 Un exemple de sortie de la liste des plug-ins wp

wp theme fait de même, uniquement pour les thèmes. Le package wp est un espace de noms de commande permettant de gérer les packages WP-CLI. Avec wp package installer somepackagename nous pouvons installer des packages tiers ajoutés à l'indice WP-CLI Package index . Certains paquets / commandes remarquables sont: wp usergen cli qui crée des utilisateurs aléatoires à des fins de test; db checkpoint qui crée des instantanés de base de données; WP-CLI buddypress qui contient un certain nombre de commandes liées à BuddyPress; Taille de WP-CLI qui indique la taille des bases de données et des tables; wp hook qui montre les fonctions de rappel enregistrées pour un filtre ou un crochet d'action particulier; query debug qui permet de déboguer les performances des requêtes; et faker qui nous aide à créer des postes de remplissage à des fins de développement.

Il existe de nombreux autres packages / commandes gérés par la communauté. La liste complète est disponible ici ici .

Conclusion

Dans ce guide, nous avons présenté WP-CLI et décrit ses principales commandes. Nous avons également présenté certains de ses packages tiers, mais il ne s'agit en aucun cas d'une référence complète. Avec WP-CLI, les possibilités et les scénarios d'utilisation sont pratiquement infinis.




Source link