Drupal 10 : Structure des fichiers

Depuis Drupal 8, le bon sens est enfin de retour. Fini les modules, profils d’installation ou thèmes à ranger dans des sous-dossiers pour ne pas se mélanger avec ceux du cœur de Drupal.

├── core
│   ├── assets
│   ├── config
│   ├── includes
│   ├── lib
│   ├── misc
│   ├── modules
│   ├── profiles
│   ├── scripts
│   ├── tests
│   └── themes
├── modules
├── profiles
├── sites
│   ├── all
│   └── default
├── themes
└── vendor

Le cœur a maintenant son propre dossier /core dans lequel sont rangés ses fichiers vitaux.

De nouveaux dossiers font leur apparition en plus de ce qu’il existait sous Drupal 7, regardons ce qu’ils regroupent :

• assets : Stockage des librairies externes Javascript. jQuery, CKeditor, Backbone.js, etc.
• config : Fichiers de définition des schémas d’une partie des données du cœur (les modules peuvent en définir d’autres).
• lib : Lieu de vie de toutes les classes qui font des trucs vachement intelligents dans Drupal. This is the place to be.
• vendor : Stockage de toutes les librairies autres que Javascript. Autoloader PSR, Twig, Composer, Behat, etc.

Les répertoires /modules, /profiles et /themes à la racine de l’installation servent enfin à accueillir vos modules, profils d’installation et thèmes contribués ou spécifiques.

Le nouveau système de configuration de Drupal permet d’exporter la configuration du site, cela se fait dans le répertoire des fichiers de Drupal. Nous conseillons de sortir le répertoire de configuration hors des fichiers servis par le serveur web en surchargeant le chemin dans le fichier settings.php afin d’éviter que n’importe qui puisse les récupérer en cas de mauvaise configuration du serveur.

Exemple :

# settings.php
$config_directories['sync'] = '../config/sync'; 

Si vos méthodes de travail vous font utiliser plusieurs environnements (site local, pré-production, production, etc) il est fort à parier que vous ayez besoin d’avoir des données de configuration spécifiques à chaque environnement.
Pour mettre cela en œuvre dans Drupal 7 il était commun d’inclure un fichier appelé settings.local.php situé dans le dossier /sites/default ou dans le dossier de votre site en cas de multi-site.
Depuis Drupal 8, cette pratique a été intégrée de base et le fichier settings.default.php vous permet d’inclure ce fichier local en retirant les commentaires des quelques lignes situées en fin de fichier.

Drupal permet désormais également d'intégrer un fichier services.yml qui va vous permettre de surcharger certains paramètres des Services implémentés par le cœur ou les modules contribués.

Voici un exemple de surcharge :

# services.yml // Activation du débug dans Twig.
  parameters:
    twig.config:
      debug: true