Multi-Site en Drupal avec lando

Dans cet article, nous apprendrons un processus étape par étape pour configurer Drupal 8 multi-site, avec une base de code partagée (unique) et une base de données distincte par site sur une machine locale, à l’aide de Lando.

Quand envisager le multisite ?

• Avant de plonger dans les détails techniques de la configuration multi-sites, voyons d’abord quand envisager une configuration multi-sites.
• Les avantages et inconvénients mentionnés ci-dessous et les raisons invoquées vous aideront à décider si le multisite convient ou non à vos sites.

Avantages:

• Facile à maintenir:
• Moins de coûts de développement :
• Ayez des thèmes et des fonctionnalités distincts pour chaque site :

Les inconvénients:

• Point de défaillance unique:
• Gestion du trafic du site :

Veuillez noter que nous n’aborderons pas les instructions d’installation de Lando. Veuillez consulter le document officiel de Lando pour plus de détails.

Commençons par mettre en place un multi-site avec lando

Étape 1 – Configuration du fichier .lando.yml

• Lando fonctionne avec un fichier de configuration, nous permettant de démarrer différents services pour que notre application fonctionne correctement. Par défaut, dans une installation normale de Drupal 9, nous n’aurions qu’à exécuter la commande lando init, et ce fichier de configuration serait généré avec tout le nécessaire pour exécuter lando et Drupal 9 sans problème.
• Cependant, dans le cas d’une installation Drupal 9 Multi-site, nous devrons créer notre fichier de configuration pour lando et le modifier selon nos besoins ; par exemple, les URL de nos sous-domaines, les données d’accès à chaque base de données, etc.
• Bien que vous puissiez ajouter de nombreuses autres configurations dans un projet de ce type, je vais vous donner ci-dessous le fichier de base, avec une explication de chaque section importante, afin que vous puissiez démarrer plusieurs sites Drupal 9 avec Lando. Allez dans le dossier où vous avez téléchargé les fichiers Drupal Base, puis créez un fichier appelé .lando.yml avec le code suivant :

Explication:

• Dans la première partie du fichier de configuration, en plus du nom du projet, nous avons les principales configurations, liées à la racine web.

• Dans la section Proxy, nous définirons les différents domaines pour nos sites Drupal ; ils doivent tous se terminer par « .lando.site» et le nom principal doivent correspondre à leur dossier d’installation respectif, comme cela se produit dans une installation Drupal 9 Multi-site traditionnelle.

• La dernière partie du fichier de configuration est l’endroit où nous définirons toutes les données liées à nos bases de données. N’oubliez pas que vous pouvez confirmer toutes les informations, une fois Lando démarré, en utilisant la commande information :

Étape 2 – Mise en place des principaux Drupal et multi-sites

A ce stade, avant de démarrer notre projet Drupal, nous devrons procéder à plusieurs ajustements :

• Renommez le fichier example.sites.php et laissez-le comme sites.php, à l’intérieur nous devrons ajouter les différents domaines et les dossiers vers lesquels chacun d’eux pointera.

• Créez les dossiers qui correspondent aux noms des domaines que vous avez déclarés dans le fichier de configuration. Le nom des dossiers doit correspondre à la fois au nom que vous avez mis dans le fichier de configuration lando et dans le sites.php de l’image précédente.

• Ajoutez des fichiers de configuration à plusieurs sites. Chaque installation Drupal nécessite au moins deux fichiers pour sa configuration : le fichier où seront définies toutes les données d’accès à votre base de données, appelé settings.php, et le dossier files, où il hébergera tous les fichiers, images, cache, etc. .
  Vous devrez donc copier le modèle depuis le fichier default.settings.php qui se trouve dans le dossier sites/default, et une fois dans chaque dossier de vos multi-sites, renommez-le en settings.php. Ensuite, vous allez créer un dossier de fichiers dans chaque dossier.

• Après avoir créé chaque dossier de site, autorisons les répertoires settings.php et /files.

          chmod a+w settings.php
         chmod a+w files

• Puisque nous disposons de tous les fichiers nécessaires pour commencer l’installation de chacun de nos Multi-sites Drupal 9, nous devons exécuter les commandes suivantes dans cet ordre pour éviter les surprises :

    lando start
    lando composer install
    lando rebuild
    lando info

• Avec la commande « lando start », nous nous assurerons que Lando démarre correctement, en utilisant la configuration que nous avons définie dans le fichier de configuration .lando.yml.
• La commande « lando composer install » commencera à télécharger le reste des dépendances nécessaires pour installer notre Drupal, car dans les fichiers, il nous manquera des dossiers principaux tels que Vendor.
• La commande « Lando Rebuild » effectue une revue générale de l’application. Une fois les fichiers téléchargés avec Composer, à la fin de l’exécution, la commande devrait nous montrer à l’écran les différentes URL disponibles pour chacun des Multi-sites.

• En cliquant sur les URL des sites ci-dessus, vous serez redirigé vers la page d’installation de Drupal.

• La commande « lando info » nous aidera à confirmer les données d’accès aux bases de données, avec leurs utilisateurs et mots de passe respectifs.
• Une fois toutes les commandes précédentes exécutées, nous pouvons commencer le processus d’installation de chacun des multi-sites, en écrivant le domaine correspondant, que nous avons défini dans le fichier de configuration lando et que nous confirmons en exécutant la commande « lando info ». N’oubliez pas que si vous installez Drupal 9 à l’aide de Lando, vous devez remplacer l’hôte local du serveur de base de données par celui qui apparaît dans la console.

• Enfin vos multi-sites sont installés avec succès. Pour un accès à la base de données multi-sites, vous pouvez utiliser :

          lando drush sql:cli --uri=http://site1.lndo.site:8080/ 

• Ici, –uri accepte l’URL du site créée ci-dessus après Lando démarre. Vous pouvez désormais accéder à leur base de données et continuer à travailler sur vos multi-sites.

Conclusion

Tout au long de ce blog, nous avons abordé des aspects cruciaux, obtenant des informations sur les configurations fondamentales du site et exploitant la puissance de Lando pour un développement fluide. Ces nouvelles connaissances nous permettent de créer des sites Drupal robustes et servent de base à nos projets futurs. En concluant ce blog, célébrons l’accomplissement de la maîtrise des configurations de base du site et de Lando, ouvrant la voie à des expériences de développement Drupal plus efficaces et rationalisées.