Qu’est ce que WP-CLI
WP-CLI est un ensemble de fonctionnalité en ligne de commande, permettant de gérer tous projets sur WordPress. Comme il est dit sur le site wp-cli.org, nous pouvons faire beaucoup de chose. Par exemple :
- Installer un site (ou un multisite)
- Générer, et gérer le fichier wp-config.php
- Mise à jour des plugins, thèmes et traductions
- etc…
Utilisation de WP-CLI…
Pour pouvoir utiliser WP-CLI, il est obligatoire d’installer sur votre poste (ou le serveur) le fichier PHAR qui va bien. Voici le script actuel d’installation :
curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar php wp-cli.phar --info chmod +x wp-cli.phar sudo mv wp-cli.phar /usr/local/bin/wp wp --info
Et c’est suffisant. En tapant la commande wp –version, vous devriez avoir cette réponse : WP-CLI 1.5.0.
Remarque : pour mettre à jour WP-CLI, il existe deux solutions, la première étant la commande wp cli update, la deuxième étant de repasser le script d’installation.
Comme je disais dans l’introduction, il est possible d’installer WordPress avec WP-CLI, en quelques lignes.
Voici le script minimal d’installation :
wp core download --locale=fr_FR wp core config --dbname=wordpress --dbuser=root --dbpass=admin --dbprefix=wp_ wp db create wp core install --url="http://local.wordpress/" --title="Example Site DEV" --admin_name=guillaume --admin_email=g.jf.richard@gmail.com --admin_password=guillaume; wp rewrite structure '/%postname%/' --hard wp rewrite flush --hard
Voici ce que fait le script, ligne par ligne :
Ligne 1 : Téléchargement des fichiers WordPress de base (en VF). Ligne 2 : Génération et lecture du fichier wp-config.php, avec les informations sur la base de donnée (nom BDD, utilisateur, mot de passe, préfixe des tables de la base) Ligne 3 : Création de la base de donnée Ligne 4 : Processus d'installation standard de WordPress, avec les informations qui vont bien (url du projet, titre du projet et informations de l'utilisateur). Ligne 5 : Met à jour la structure des liens (par exemple : /%postname%/) Ligne 6 : Réécriture des règles
On obtient l’installation suivante :
Et configuration plus poussé…
Il est possible d’améliorer ce dernier script, grâce à un fichier de configuration.
Vous pouvez en savoir plus directement sur la page dédié du site make.wordpress.org, la page est en anglais.
En quelques mots, WP-CLI peut automatiquement découvrir et lire les options d’un fichier de configuration (si il existe).
WP-CLI détecte tout d’abord le fichier wp-cli.local.yml, présent dans le répertoire courant du projet. Il détecte ensuite le fichier wp-cli.yml, présent aussi dans le dossier courant du projet.
Pour finir, la détection de ~/.wp-cli/config.yml. Le chemin du fichier doit être défini par la variable d’environnement WP_CLI_CONFIG_PATH.
Le fichier de configuration peut contenir beaucoup de chose, comme :
- Les variables globales (de la BDD, des utilsateurs, etc…)
- Les commandes à désactivées (selon l’environnement)
- Les plugins et thèmes a installer (ou à désinstaller).
- etc…
Il existe un exemple de fichier wp-cli.yml, sur la page dédié du site make.wordpress.org. Il est compréhensible.
Voici le fichier de configuration que je veux utiliser pour améliorer mon script d’installation :
# Global parameter defaults
color: true
apache_modules:
- mod_rewrite
rewrite structure:
- /%year%/%monthnum%/%postname%/
core download:
locale: fr_FR
core install:
admin_user: guillaume
admin_password: guillaume
admin_email: g.jf.richard@gmail.com
title: WordPress Development
url: http://local.wordpress/
core config:
dbuser: root
dbpass: admin
dbhost: localhost
dbname: wordpress
dbprefix: wp_
extra-php: |
define('WP_DEBUG', true);
define('WP_CACHE', false);
Reprenons mon précédent script d’installation de WP et modifions-le pour qu’il corresponde au fichier de configuration précédent.
Voici ce que cela donne :
wp core download wp core config wp db create wp core install wp rewrite structure --hard wp rewrite flush --hard
En l’état, si vous lancez ce script, vous vous retrouverez avec un WordPress minimal, correspondant à l’autre script d’installation.
Vous pourrez réutilisez ce script avec tous les fichiers de configuration wp-cli.yml que vous aurez, quelque soit le projet, quelque soit l’environnement.
A partir de là, vous pourrez installer facilement n’importe quel projet WP en quelques secondes.
Si vous avez des questions en relation à l’article, ou si vous voulez des précisions, n’hésitez pas à me le dire en commentaires, ou par mail.
Liens
L’interface de ligne de commande pour WordPress : https://wp-cli.org/fr/
Commandes WP-CLI https://developer.wordpress.org/cli/commands/
Handbook wp-cli https://make.wordpress.org/cli/handbook/
