Drush pour les pros : gestion de Drupal via la ligne de commande (CLI)

Gérer Drupal efficacement en ligne de commande

Drupal peut être entièrement administré via l’interface d’administration. Pour de nombreuses tâches quotidiennes, le backend est également le bon endroit : modifier des contenus, gérer les utilisateurs, adapter les menus ou changer des configurations simples. Toutefois, dès qu’un site Drupal est exploité de manière professionnelle, régulièrement mis à jour ou développé, la ligne de commande est nettement plus rapide et plus fiable. C’est précisément à cela que sert Drush.

Drush signifie Drupal Shell et désigne un outil en ligne de commande spécialement conçu pour Drupal. Avec Drush, les administrateurs et les développeurs peuvent exécuter directement dans le terminal des tâches courantes de maintenance, de développement et de diagnostic. Cela comprend notamment la reconstruction des caches, les mises à jour de base de données, les contrôles de statut, les exports de configuration, l’activation ou la désinstallation de modules, les exécutions cron, la gestion des utilisateurs et bien d’autres tâches.

Le grand avantage est simple : au lieu de cliquer à travers plusieurs pages du backend, vous exécutez une commande et obtenez immédiatement un résultat. Drush permet de gagner beaucoup de temps, en particulier lors des mises à jour, du dépannage, des processus de déploiement et des travaux de maintenance récurrents. Pour les agences, les développeurs et les exploitants de sites avancés, Drush fait donc partie des outils les plus importants de l’écosystème Drupal.

Qu’est-ce que Drush ?

Drush n’est pas un module Drupal classique que vous activez dans le backend. Il s’agit d’un outil en ligne de commande séparé, installé dans votre projet Drupal et exécuté via le terminal. Les projets Drupal modernes sont généralement gérés avec Composer. Drush est alors également installé comme dépendance Composer dans le projet.

Lorsque Drush est correctement configuré, vous pouvez exécuter des commandes comme celles-ci :

Selon la configuration du serveur et les paramètres de chemin, la commande peut aussi être disponible directement sous la forme drush. Dans de nombreux environnements d’hébergement, l’exécution spécifique au projet via vendor/bin/drush est toutefois la variante la plus propre et la plus traçable.

Quand Drush est-il utile ?

Drush est particulièrement intéressant lorsque vous ne modifiez pas seulement occasionnellement un site Drupal, mais que vous en assurez la maintenance technique. Pour de simples modifications de contenu, Drush n’est pas nécessaire. Pour la maintenance, le développement et l’administration professionnelle, il représente en revanche un gain d’efficacité important.

Les domaines d’utilisation typiques sont :

• Vider et reconstruire les caches : Très utile après des adaptations de thème, des modifications de modules ou des changements de configuration.
• Exécuter les mises à jour de base de données : Important après les mises à jour de Drupal Core ou de modules.
• Vérifier l’état du système : Contrôle rapide de la version Drupal, de la base de données, de PHP, de l’URI du site et des chemins.
• Exécuter cron : Démarrer manuellement les tâches planifiées de Drupal.
• Activer ou désinstaller des modules : Particulièrement pratique dans les environnements de développement et de staging.
• Exporter et importer la configuration : Important pour les workflows de déploiement entre les systèmes de développement, de test et de production.
• Gérer les utilisateurs : Par exemple réinitialiser un mot de passe ou générer un lien de connexion unique.
• Automatisation : Les commandes Drush peuvent être utilisées dans des scripts, des processus de déploiement ou des procédures de maintenance.

Les personnes qui utilisent Drupal uniquement comme rédacteurs n’ont généralement pas besoin de Drush. En revanche, toute personne qui installe, maintient, étend ou exploite Drupal pour des projets clients devrait connaître Drush.

Conditions requises chez CURIAWEB

Pour utiliser Drush, vous avez besoin d’un accès à la ligne de commande de votre pack d’hébergement. Chez CURIAWEB, cela se fait via un accès SSH. SSH vous permet de vous connecter au serveur en toute sécurité et d’y exécuter des commandes.

Pour une utilisation productive de Drush, les conditions suivantes devraient être remplies :

• un accès SSH actif,
• une installation Drupal gérée avec Composer,
• une version PHP appropriée conformément aux exigences de Drupal et de Drush,
• un accès Composer dans le répertoire du projet,
• des droits utilisateur suffisants pour les fichiers, répertoires et l’accès à la base de données,
• la connaissance du chemin du projet de votre installation Drupal.

Dans les environnements d’hébergement mutualisé, vous devez particulièrement veiller à utiliser le bon binaire PHP CLI. La version PHP du serveur web et la version PHP en ligne de commande peuvent être différentes. Si Drush affiche des erreurs inattendues, la version PHP CLI est donc l’un des premiers points à vérifier.

Installer Drush

Pour les sites Drupal modernes, Drush est généralement installé directement dans le projet via Composer. Pour cela, connectez-vous en SSH et placez-vous dans le répertoire principal de votre projet Drupal. Il s’agit du répertoire dans lequel se trouve le fichier composer.json.

Après l’installation, Drush se trouve normalement dans le répertoire vendor/bin/. Vous pouvez vérifier l’installation avec la commande suivante :

Si une version de Drush est affichée, l’outil est en principe disponible. Vous pouvez ensuite utiliser vendor/bin/drush status pour vérifier si Drush reconnaît correctement votre installation Drupal.

Exécuter Drush depuis le bon répertoire

De nombreux problèmes avec Drush apparaissent parce que la commande est exécutée dans le mauvais répertoire. Drush doit pouvoir reconnaître l’installation Drupal. Commencez donc par vous placer dans le répertoire du projet où se trouve le fichier composer.json. Dans les installations Drupal basées sur Composer, la racine web publique se trouve souvent dans un sous-répertoire tel que web ou docroot. Le répertoire du projet se situe alors un niveau au-dessus.

Une structure typique ressemble à ceci :

Dans cet exemple, vous exécutez Drush depuis le répertoire /home/utilisateur/projet-drupal/ :

Si vous vous trouvez dans le mauvais répertoire, Drush peut ne pas être en mesure de démarrer complètement le site. Des messages d’erreur peuvent alors apparaître, même si Drush est correctement installé.

Aperçu des commandes Drush les plus importantes

Drush possède de très nombreuses commandes. Pour le travail quotidien, quelques commandes de base suffisent toutefois et devraient être maîtrisées. L’aperçu suivant présente des commandes particulièrement utilisées.

De nombreuses commandes Drush disposent de formes courtes. Ainsi, drush cr est la forme abrégée bien connue de Cache Rebuild. Il est néanmoins utile de connaître aussi les formes longues, car elles sont souvent plus explicites et plus fréquemment utilisées dans les documentations.

Reconstruire le cache avec Drush

La commande Drush probablement la plus utilisée est la reconstruction du cache :

Cette commande vide et reconstruit les caches Drupal. Cela est nécessaire ou utile lorsque des modifications ne sont pas visibles, lorsque de nouvelles configurations doivent être prises en compte ou lorsqu’un état incohérent apparaît après des ajustements de modules ou de thèmes.

Une reconstruction du cache est en principe une commande sûre, mais elle peut entraîner temporairement une charge serveur plus élevée, car Drupal doit ensuite reconstruire les caches. Sur des sites en production très fréquentés, elle doit donc être utilisée consciemment, en particulier pendant les pics de charge.

Exécuter les mises à jour de base de données avec Drush

Après les mises à jour de Drupal Core ou des modules installés, des mises à jour de base de données peuvent être nécessaires. Elles peuvent être exécutées via le backend avec update.php ou via Drush. La commande Drush est :

Selon la version de Drush, la forme courte drush updb est également courante. Avant d’exécuter cette commande, vous devriez impérativement créer une sauvegarde. Les mises à jour de base de données modifient la structure ou le contenu de la base de données et ne peuvent pas toujours être annulées facilement.

Une procédure sûre ressemble à ceci :

1. Créer une sauvegarde complète des fichiers et de la base de données.
2. Mettre le site en mode maintenance.
3. Effectuer les mises à jour du code via Composer.
4. Exécuter les mises à jour de base de données avec vendor/bin/drush updatedb.
5. Reconstruire le cache avec vendor/bin/drush cr.
6. Tester le site.
7. Désactiver à nouveau le mode maintenance.

Activer et désactiver le mode maintenance avec Drush

Lors de mises à jour importantes ou de travaux de maintenance critiques, les visiteurs ne devraient pas accéder à un site partiellement mis à jour. Pour cela, vous utilisez le mode maintenance. Avec Drush, vous pouvez définir rapidement cet état :

Une fois la maintenance terminée, désactivez à nouveau le mode maintenance :

La reconstruction du cache qui suit est importante afin que Drupal prenne correctement en compte le changement de statut. Vérifiez ensuite le site dans une fenêtre de navigateur dans laquelle vous n’êtes pas connecté en tant qu’administrateur.

Gérer les modules avec Drush

Drush peut activer ou désinstaller des modules. Mais il est important de noter que le téléchargement et la gestion du code des modules se font normalement via Composer dans les projets Drupal modernes. Drush ne remplace pas Composer. Il active uniquement les extensions déjà présentes dans le projet.

Une procédure typique pour installer un nouveau module ressemble à ceci :

La forme courte pour activer un module est souvent :

Pour désinstaller, utilisez :

Ne désinstallez jamais des modules à l’aveugle. Vérifiez d’abord si d’autres modules, configurations ou contenus en dépendent. En particulier sur les sites en production, de telles modifications devraient d’abord être effectuées dans un environnement de test.

Vérifier l’état de Drupal

La commande status est idéale pour obtenir un aperçu technique rapide :

Selon la version et l’environnement, Drush affiche des informations telles que la version de Drupal, l’URI du site, la connexion à la base de données, la version PHP, le chemin de configuration, les chemins de fichiers et la version de Drush. Ces informations sont particulièrement utiles pour le dépannage, les cas de support et les travaux de migration.

Si Drush ne peut pas afficher un statut valide, vérifiez d’abord :

• Êtes-vous dans le bon répertoire de projet ?
• Drush est-il installé dans le projet sous vendor/bin/drush ?
• L’installation Drupal est-elle entièrement configurée ?
• Le fichier settings.php existe-t-il et est-il correct ?
• La version PHP en ligne de commande est-elle correcte ?
• La base de données est-elle accessible ?

Exécuter cron manuellement avec Drush

Drupal utilise cron pour les tâches récurrentes. Cela comprend notamment le traitement des files d’attente, la mise à jour de certaines données, le nettoyage des informations temporaires ou l’indexation des contenus. Cron peut être configuré automatiquement, mais il peut aussi être lancé manuellement via Drush :

Cette commande est utile si vous souhaitez tester si les tâches cron fonctionnent correctement ou si certains processus d’arrière-plan doivent être exécutés immédiatement. Pour les sites plus importants, cron devrait être automatisé de manière fiable afin que les tâches de maintenance ne soient pas oubliées.

Exporter et importer la configuration

L’un des principaux atouts des versions modernes de Drupal est la gestion de configuration. Les paramètres des types de contenu, champs, Views, menus, rôles, formats d’affichage et de nombreux autres éléments structurels peuvent être exportés et versionnés. Drush est un outil central pour cela.

Exporter la configuration :

Importer la configuration :

En forme courte, ces commandes sont souvent utilisées sous les noms drush cex et drush cim. Elles sont particulièrement pertinentes lorsqu’un site est exploité dans plusieurs environnements, par exemple localement, en staging et en production.

Un workflow typique :

1. Modifier la configuration localement ou dans un environnement de développement.
2. Exporter la configuration avec Drush.
3. Versionner les modifications dans Git.
4. Déployer le code et la configuration vers l’environnement cible.
5. Importer la configuration sur cet environnement avec Drush.
6. Exécuter les mises à jour de base de données et reconstruire le cache.

Les imports de configuration doivent être effectués avec beaucoup de prudence sur les sites en production. Un import peut écraser des paramètres existants. Vérifiez donc au préalable quelles modifications seront importées.

Rétablir l’accès utilisateur avec Drush

Drush est également utile lorsque l’accès administrateur ne fonctionne plus. Avec la commande suivante, vous pouvez générer un lien de connexion unique pour un utilisateur :

Selon les besoins, vous pouvez spécifier un utilisateur précis. Le lien généré ne devrait être utilisé que via des canaux sécurisés et ne doit pas être partagé publiquement. Il permet un accès direct et est donc sensible du point de vue de la sécurité.

Pour une exploitation productive, il est en outre recommandé de :

• utiliser des mots de passe forts,
• configurer l’authentification à deux facteurs pour les administrateurs,
• ne pas utiliser de comptes administrateur partagés,
• désactiver les comptes utilisateur inutilisés,
• vérifier régulièrement les rôles et les autorisations.

Drush et Composer : une répartition claire des tâches

Drush et Composer sont souvent utilisés ensemble, mais ils remplissent des fonctions différentes. Composer gère les paquets PHP, Drupal Core, les modules, les thèmes et les bibliothèques. Drush exécute des commandes spécifiques à Drupal sur une installation existante.

Cette séparation est importante pour des projets Drupal stables. Utilisez Composer pour les dépendances et le code. Utilisez Drush pour les opérations internes à Drupal.

Processus de mise à jour sécurisé avec Composer et Drush

Un processus professionnel de mise à jour Drupal combine Composer, Drush, sauvegardes et tests. La procédure exacte dépend du projet. Un déroulement typique peut ressembler à ceci :

1. Créer une sauvegarde : Sauvegardez entièrement les fichiers et la base de données.
2. Planifier une fenêtre de maintenance : Les mises à jour importantes ne devraient pas être effectuées pendant les heures de pointe.
3. Activer le mode maintenance : Les visiteurs voient une page de maintenance au lieu d’éventuels messages d’erreur.
4. Mettre à jour le code : Mettre à jour Drupal Core et les modules via Composer.
5. Exécuter les mises à jour de base de données : Avec vendor/bin/drush updatedb.
6. Reconstruire le cache : Avec vendor/bin/drush cr.
7. Tester le site : Vérifier le backend, le frontend, les formulaires, la connexion, les types de contenu importants et les fonctions critiques.
8. Désactiver le mode maintenance : Rendre le site à nouveau accessible.
9. Effectuer le monitoring : Vérifier les messages de log et les rapports d’erreurs.

Sur les sites en production, ce processus devrait d’abord être testé dans un environnement de staging. Cela permet de détecter les conflits de modules, les dépendances modifiées ou les problèmes de base de données avant que les visiteurs ne soient affectés.

Drush dans les workflows de staging et de déploiement

Drush déploie toute sa puissance dans les workflows professionnels. Lorsque vous travaillez avec des environnements de développement, de staging et de production, les commandes Drush peuvent standardiser les étapes récurrentes. Cela réduit le risque d’erreurs manuelles.

Les étapes typiques de déploiement peuvent être :

Le paramètre -y confirme automatiquement les questions. Il est pratique pour les déploiements automatisés, mais ne devrait être utilisé que lorsque le processus a été testé et compris. Sur les systèmes de production, une confirmation automatique peut sinon déclencher des modifications indésirables.

Erreurs fréquentes et leurs causes

Les erreurs Drush peuvent parfois sembler compliquées au premier abord. Cependant, de nombreux problèmes ont des causes typiques. L’aperçu suivant aide au premier diagnostic.

Lors du dépannage, vendor/bin/drush status est souvent la meilleure première commande. Elle montre si Drush reconnaît correctement le site.

Règles de sécurité pour Drush

Drush est puissant. C’est précisément pourquoi les commandes doivent être exécutées avec soin. Certaines commandes modifient la base de données, la configuration, les utilisateurs ou les extensions activées. Les erreurs peuvent avoir un effet immédiat sur le site en production.

Respectez donc ces règles de sécurité :

• N’exécutez des commandes de production que si vous comprenez leur effet.
• Créez toujours des sauvegardes avant les mises à jour et les opérations sur la base de données.
• Pour les changements importants, travaillez d’abord dans un environnement de staging.
• N’utilisez pas d’accès SSH partagés.
• Limitez l’accès SSH aux personnes qui en ont réellement besoin.
• Ne stockez pas de mots de passe dans l’historique shell ou dans des scripts non sécurisés.
• Utilisez des clés SSH sécurisées et des phrases secrètes fortes.
• Vérifiez les logs Drupal après les travaux de maintenance.

Les commandes avec confirmation automatique comme -y devraient être utilisées uniquement dans des workflows contrôlés. Pour les travaux manuels, il est souvent plus sûr de confirmer consciemment les questions.

Drush et performance

Drush ne rend pas automatiquement votre site plus rapide. Il vous aide toutefois à effectuer plus efficacement les travaux de maintenance liés à la performance. Cela comprend les reconstructions de cache, les exécutions cron, les mises à jour, les imports de configuration et les processus de déploiement. En particulier pour les sites Drupal complexes avec de nombreux modules, Views et types de contenu, une gestion rapide via CLI peut réduire considérablement la charge administrative.

Pour les très grands projets ou les environnements de développement avec des processus Composer et Drush fréquents, un hébergement plus performant peut être judicieux. Davantage de puissance CPU, de mémoire vive et de meilleures performances I/O ont un effet positif surtout sur les opérations Composer, la reconstruction des caches et les opérations de base de données.

Pour les projets Drupal exigeants, les environnements de staging ou les workflows de développement personnalisés, un VPS Cloud Server de CURIAWEB peut être une solution pertinente. Il offre davantage de ressources et plus de flexibilité technique que les environnements d’hébergement mutualisé classiques.

Courte checklist pour l’utilisation de Drush

• L’accès SSH est activé et configuré de manière sécurisée.
• Le site Drupal est géré avec Composer.
• Drush est installé spécifiquement au projet via Composer.
• Vous exécutez Drush depuis le bon répertoire de projet.
• vendor/bin/drush status reconnaît correctement le site.
• Une sauvegarde actuelle existe avant les mises à jour.
• Le mode maintenance est utilisé pour les travaux importants.
• Les mises à jour de base de données sont exécutées après les mises à jour du code.
• Le cache est reconstruit après les modifications.
• Les commandes de production sont d’abord testées en staging lorsqu’il existe un risque.

FAQ sur Drush

Conclusion : Drush est une connaissance indispensable pour la gestion professionnelle de Drupal

Drush est l’un des outils les plus importants pour l’administration professionnelle de Drupal. Il accélère considérablement la maintenance, les mises à jour, le diagnostic, le développement et le déploiement. Toute personne qui assure la gestion technique de projets Drupal devrait maîtriser les commandes Drush de base et savoir quand Composer, Drush ou le backend est le bon outil.

Drush est particulièrement précieux pour les tâches récurrentes : reconstruire le cache, exécuter les mises à jour de base de données, lancer cron, exporter la configuration ou gérer les modules. En combinaison avec un accès SSH, Composer, des sauvegardes et un environnement de staging, il crée un workflow propre pour des sites Drupal fiables.