Si vous avez suivi notre guide sur l'installation de Drupal avec Lando, vous êtes prêt à faire passer votre environnement de développement local à un niveau supérieur. Je vous présente Drush, votre nouveau meilleur ami. Drush est un outil dans la ligne de commande qui permet de gérer les sites Drupal. C'est comme une clé magique qui déverrouille certains pouvoirs secrets de Drupal. Il vous offrira la possibilité de gérer entièrement votre site Drupal, sans jamais quitter votre ligne de commande. Avec Lando, Drush est pré-installé, ce qui simplifie encore plus votre travail. Ce guide énumère les commandes essentielles de Drush et vous apprendra les secrets des développeurs pour maximiser votre productivité avec Drupal.

Qu'est-ce que Drush ?

Drush, acronyme de Drupal Shell, est un puissant outil de ligne de commande spécialement conçu pour la gestion des sites Drupal. Conçu pour rendre les tâches d'administration et de développement plus rapides et plus efficaces, Drush permet aux développeurs de gérer pratiquement tous les aspects d'un site Drupal sans avoir besoin d'accéder à l'interface web. Cet outil est particulièrement précieux pour les développeurs qui souhaitent automatiser des tâches répétitives, gérer des flux de travail complexes ou résoudre des problèmes de manière plus efficace.

Avec Drush, vous pouvez effectuer un large éventail d'opérations directement à partir du terminal, telles que :

• Gestion des modules et des thèmes : Installez, activez, désactivez et désinstallez rapidement les modules et les thèmes, ce qui est beaucoup plus rapide qu'en utilisant l'interface web.
   
• Gestion des bases de données : Exécutez des sauvegardes, des restaurations et des mises à jour de la base de données, ce qui facilite la gestion du backend de Drupal sans nécessiter d'outils de base de données supplémentaires.
   
• Cache et performances : Effacer et reconstruire les caches pour dépanner ou rafraîchir les performances du site. Cette fonction est particulièrement utile pendant le développement, car les données mises en cache peuvent parfois empêcher les modifications de s'afficher correctement.
   
• Gestion de la configuration : Drush fournit des outils pour exporter, importer et synchroniser les configurations, ce qui est crucial pour déplacer les paramètres et les personnalisations entre les environnements (comme du développement à la production).
   
• Gestion des utilisateurs : Créez, mettez à jour, supprimez des utilisateurs, attribuez des rôles, gérez les permissions et connectez-vous à n'importe quel compte avec seulement quelques commandes.
   
• Tâches Cron : Exécuter des tâches programmées à la demande. Les sites Drupal s'appuient souvent sur des tâches cron pour les tâches de maintenance, telles que la vérification des mises à jour et le nettoyage des entrées du journal, et Drush facilite le déclenchement manuel de ces tâches en cas de besoin.

L'une des plus grandes forces de Drush est sa polyvalence, qui lui permet de s'adapter à des flux de développement complexes. De nombreux développeurs s'appuient sur Drush pour automatiser une grande partie de leur travail, en écrivant des scripts qui gèrent les tâches répétitives ou en déployant des commandes personnalisées pour les besoins d'un site.

Utiliser Drush avec Lando

Avec Lando, Drush est disponible dans votre environnement sans aucune configuration supplémentaire. Toutes les commandes Drush peuvent être précédées du préfixe lando pour les exécuter dans votre environnement Lando. Si vous n'avez pas encore installé Drupal avec Lando ou si vous avez besoin de vous rafraîchir la mémoire concernant l'utilisation de la ligne de commande, nous vous recommandons de suivre notre guide qui décrit le processus étape par étape : Comment installer Drupal avec Lando

Commandes de base et configuration

Tout d'abord, vous devez vous assurer que vous avez installé Drupal avec Lando et que votre environnement Lando est opérationnel.

Une fois que c'est fait, naviguez jusqu'au répertoire de votre projet Drupal :

cd my-drupal-site

Et démarrez l'environnement :

lando start

Une fois démarré, vous pouvez commencer à utiliser les commandes Drush avec le préfixe lando.

Commandes essentielles pour Drush avec Lando

Vérifier le statut de Drupal

La commande st, ou status vérifie l'état de votre site Drupal, en affichant des informations essentielles sur l'installation, notamment la version de Drupal core, la version de PHP, l'état de la connexion à la base de données et les autorisations d'accès aux fichiers. Cette commande est utile pour vérifier rapidement que votre environnement est correctement configuré. La plupart des commandes ont une version courte, ou alias :

lando drush st

Pour chacune de ces commandes, vous pouvez également utiliser le nom complet :

lando drush status

Générer un lien de connexion à usage unique

La commande uli, ou user-login génère un lien de connexion unique pour un utilisateur spécifié ou pour l'utilisateur admin si aucun nom d'utilisateur n'est fourni. Ce lien permet de contourner l'écran de connexion, permettant un accès immédiat au site Drupal, ce qui est particulièrement utile si vous avez oublié le mot de passe de l'administrateur ou si vous voulez tester les permissions. Utilisez --name suivi du nom d'utilisateur pour spécifier un compte utilisateur différent.

lando drush uli

Pour générer un lien de connexion pour un utilisateur spécifique, incluez le nom d'utilisateur :

lando drush uli --name="username"

Vous pouvez également aller plus loin et générer des liens avec l'identifiant de l'utilisateur. Par exemple, avec l'identifiant 3 :

lando drush uli --uid=3

Ou même, en utilisant l'adresse e-mail de l'utilisateur :

lando drush uli --mail=user@example.com

Effacer la mémoire cache

Drupal utilise la mise en cache pour améliorer les performances en stockant des copies de données qui devraient autrement être générées à plusieurs reprises. Cependant, les données mises en cache peuvent parfois causer des problèmes pendant le développement en empêchant les modifications d'apparaître immédiatement. La commande cr, ou cache-rebuild efface tous les caches, garantissant que votre site reflète les dernières modifications.

lando drush cache-rebuild

Activer un module

Les modules ajoutent des fonctionnalités à votre site Drupal. La commande en, ou enable active un module dans la configuration de votre site, le rendant prêt à l'emploi. Remplacez module_name par le module que vous souhaitez activer, comme pathauto ou views. Cette commande vous permet d'activer rapidement de nouvelles fonctionnalités sans avoir à naviguer dans l'interface d'administration.

lando drush en module_name

Désactiver un module

Si un module n'est plus nécessaire ou pose des problèmes, vous pouvez le désactiver à l'aide de la commande pmu, ou pm-uninstall. La désactivation d'un module peut contribuer à réduire l'utilisation des ressources ou à résoudre des conflits sans supprimer définitivement le module de votre projet.

lando drush pmu module_name

Mise à jour de Drupal Core ou des modules

La commande up, ou update permet de mettre à jour Drupal Core ou les modules installés à la dernière version. La mise à jour de Drupal et de ses modules permet de se protéger contre les failles de sécurité et d'inclure des améliorations et de nouvelles fonctionnalités. Vous pouvez mettre à jour Drupal Core spécifiquement avec up drupal, ou mettre à jour tous les modules en parallèle.

Pour mettre à jour le noyau de Drupal :

lando drush up drupal

Pour mettre à jour tous les modules :

lando drush up

Exécuter les mises à jour de la base de données

Après avoir mis à jour les modules ou Drupal Core, il se peut que vous deviez appliquer des modifications au schéma de votre base de données. La commande updb, ou update database exécute toutes les mises à jour nécessaires de la base de données, en s'assurant que la structure de la base de données de votre site s'aligne sur le code mis à jour.

lando drush updb

Exporter la configuration

Par défaut, Drupal stocke la configuration, comme les paramètres du site et les configurations des modules, dans la base de données. Pour faciliter la cohérence des configurations entre les environnements (par exemple, le développement, le stage et la production), Drupal permet d'exporter la configuration. La commande cex, ou config-export exporte toute la configuration dans des fichiers, qui peuvent ensuite être versionnés et partagés.

lando drush cex

Importation de la configuration

Pour appliquer les changements de configuration d'un environnement à un autre (par exemple, d'un environnement de développement à un environnement de production), vous pouvez utiliser la commande cim, ou config-import. Celle-ci importera les paramètres de configuration des fichiers exportés dans votre base de données.

lando drush cim

Créer un utilisateur

La création de nouveaux comptes d'utilisateur est souvent nécessaire pour effectuer des tests ou accorder un accès à des collaborateurs. La commande ucrt, ou user-create crée un nouveau compte utilisateur avec le nom d'utilisateur, l'adresse électronique et le mot de passe spécifiés, ce qui vous permet de créer rapidement des comptes de test ou d'accorder l'accès à d'autres personnes.

lando drush ucrt username --mail="user@example.com" --password="password"

Définir ou réinitialiser un mot de passe utilisateur

La commande upwd, ou user-password vous permet de définir ou de réinitialiser le mot de passe d'un compte utilisateur spécifié, ce qui est particulièrement utile si vous devez retrouver l'accès à un compte ou créer un mot de passe connu à des fins de test. Il suffit de spécifier le nom d'utilisateur et le nouveau mot de passe.

lando drush upwd username --password="newpassword"

Remplacez username par le nom d'utilisateur du compte que vous souhaitez mettre à jour et newpassword par le mot de passe souhaité.

Exécuter Cron

Les tâches cron dans Drupal automatisent les tâches planifiées telles que l'effacement des entrées du journal, la vérification des mises à jour et l'exécution de scripts de maintenance personnalisés. La commande cron déclenche manuellement ces tâches programmées, ce qui peut être utile si vous avez besoin qu'elles s'exécutent immédiatement au lieu d'attendre l'intervalle programmé.

lando drush cron

Accéder à la documentation de Drush

La commande topic permet d'accéder aux rubriques de la documentation intégrée de Drush, qui offrent des informations détaillées sur les différentes commandes et l'utilisation de Drush. Cette commande est particulièrement utile pour en savoir plus sur les capacités de Drush, explorer des options de commande spécifiques ou trouver des exemples utiles. L'exécution de cette commande sans arguments supplémentaires affichera une liste des rubriques disponibles. Pour voir les détails d'un sujet particulier, incluez le nom du sujet.

lando drush topic

Par exemple, pour afficher des informations détaillées sur la gestion de la configuration :

lando drush topic config

Drush est un outil précieux pour les développeurs Drupal, et l'associer à Lando rend le développement local plus efficace. Drush vous permet d'effectuer des tâches essentielles d'administration de Drupal directement à partir de la ligne de commande. Essayez d'incorporer ces commandes Drush dans votre flux de travail quotidien pour voir combien de temps elles peuvent vous faire gagner !