Structure des fichiers

Comprendre la structure des fichiers Drupal est essentiel pour naviguer efficacement dans un projet et savoir où placer vos personnalisations.

🗂️ Vue d’ensemble

• Répertoiretailstore/ (Racine du projet)

  • composer.json
  • composer.lock
  • Répertoireconfig/ (Configuration exportée)

    • Répertoiresync/

      • …
  • Répertoirevendor/ (Dépendances - NE PAS MODIFIER)

    • …
  • Répertoireweb/ (Racine web / Docroot)

    • Répertoirecore/ (Cœur Drupal - NE PAS MODIFIER)

      • …
    • Répertoiremodules/

      • Répertoirecontrib/ (Modules téléchargés)

        • …
      • Répertoirecustom/ (Vos modules)

        • …
    • Répertoirethemes/

      • Répertoirecontrib/ (Thèmes téléchargés)

        • …
      • Répertoirecustom/ (Vos thèmes)

        • …
    • Répertoiresites/

      • Répertoiredefault/

        • Répertoirefiles/ (Fichiers uploadés)

          • …
        • settings.php (Configuration)
    • index.php (Point d’entrée)
    • .htaccess (Config Apache)

📁 Détail des dossiers

📦 Racine du projet

Dossier/Fichier	Description
composer.json	Configuration des dépendances
composer.lock	Versions verrouillées
vendor/	Bibliothèques PHP (généré par Composer)
config/sync/	Configuration exportée (YAML)
web/	Racine web (docroot)

Ne jamais modifier

• Le dossier vendor/ est géré par Composer
• Vos modifications seraient écrasées à chaque composer install

🌐 Dossier web/

C’est le docroot - le seul dossier accessible depuis le navigateur.

web/core/

Le cœur de Drupal. Contient :

core/
├── includes/           # Fichiers d'inclusion PHP
├── lib/               # Classes Drupal (Drupal\Core\...)
├── modules/           # Modules du core (node, user, views, etc.)
├── themes/            # Thèmes du core (Olivero, Stark, Claro)
├── profiles/          # Profils d'installation
├── assets/            # CSS, JS, images du core
└── core.services.yml  # Définition des services

Ne jamais modifier core/

Toutes vos personnalisations doivent être faites via des modules ou thèmes custom.

web/modules/

modules/
├── contrib/           # Modules téléchargés via Composer
│   ├── admin_toolbar/
│   ├── pathauto/
│   └── webform/
└── custom/            # VOS modules personnalisés
    └── tailstore_custom/

Convention

• contrib/ pour les modules de drupal.org
• custom/ pour vos propres modules

web/themes/

themes/
├── contrib/           # Thèmes téléchargés
│   └── bootstrap/
└── custom/            # VOS thèmes personnalisés
    └── tailstore/

web/sites/

sites/
├── default/
│   ├── settings.php      # Configuration principale
│   ├── settings.local.php # Config locale (optionnel)
│   ├── services.yml      # Services personnalisés
│   └── files/            # Fichiers uploadés
│       ├── css/          # CSS agrégé
│       ├── js/           # JS agrégé
│       └── styles/       # Images dérivées
└── sites.php             # Multi-site (optionnel)

📋 Dossier config/

config/
└── sync/              # Configuration exportée
    ├── system.site.yml
    ├── node.type.product.yml
    ├── field.field.node.product.*.yml
    └── views.view.products.yml

Ce dossier contient les fichiers YAML exportés par drush cex. C’est le cœur du système de configuration sync.

Sécurité : Configuration hors du docroot

Pourquoi sortir la configuration du docroot ?

Le dossier config/sync/ est intentionnellement placé en dehors du docroot (web/) pour des raisons de sécurité critiques :

🚨 Risques si la config était dans le docroot

• Fuite de données sensibles : Les fichiers YAML contiennent des informations comme :

  • Clés API (Stripe, services externes)
  • Configurations de sécurité
  • Paramètres système confidentiels
  • Données de connexion à des services tiers

• Accès non autorisé : Si un attaquant accède au serveur web, il pourrait :

  • Télécharger toute votre configuration
  • Découvrir des vulnérabilités dans vos services connectés
  • Comprendre l’architecture de votre site pour mieux l’attaquer

• Exposition accidentelle : Une mauvaise configuration du serveur web pourrait rendre ces fichiers accessibles via HTTP.

✅ Avantages de la séparation

• Isolation des données sensibles : La config reste inaccessible depuis le web
• Contrôle d’accès granulaire : Seuls les processus système et les admins ont accès
• Conformité sécurité : Respecte les bonnes pratiques de sécurité web
• Prévention des fuites : Même en cas de compromission du site, la config reste protégée

Rappelez-vous : Le docroot (web/) est public, tout le reste doit être considéré comme privé !

📄 Fichiers importants

composer.json

{
    "name": "drupal/recommended-project",
    "require": {
        "drupal/core-recommended": "^11.0",
        "drupal/admin_toolbar": "^3.4",
        "drush/drush": "^13.0"
    },
    "extra": {
        "installer-paths": {
            "web/modules/contrib/{$name}": ["type:drupal-module"],
            "web/themes/contrib/{$name}": ["type:drupal-theme"]
        }
    }
}

web/sites/default/settings.php

Fichier de configuration principal :

<?php

// Configuration de la base de données
$databases['default']['default'] = [
  'database' => 'tailstore',
  'username' => 'db',
  'password' => 'db',
  'host' => 'db',
  'driver' => 'mysql',
];

// Chemin vers la configuration sync
$settings['config_sync_directory'] = '../config/sync';

// Salt pour les hashs
$settings['hash_salt'] = 'VOTRE_HASH_UNIQUE';

// Trusted hosts
$settings['trusted_host_patterns'] = [
  '^tailstore\.ddev\.site$',
  '^localhost$',
];

web/sites/default/settings.local.php

Configuration locale (non commitée) :

<?php

// Activer le mode développement
$config['system.performance']['css']['preprocess'] = FALSE;
$config['system.performance']['js']['preprocess'] = FALSE;

// Afficher les erreurs
$config['system.logging']['error_level'] = 'verbose';

// Désactiver le cache de rendu
$settings['cache']['bins']['render'] = 'cache.backend.null';

// Clés Stripe (dev)
$settings['stripe_public_key'] = 'pk_test_xxxx';
$settings['stripe_secret_key'] = 'sk_test_xxxx';

Créer settings.local.php

1. Copiez sites/example.settings.local.php vers sites/default/settings.local.php
2. Décommentez l’inclusion dans settings.php
3. Ajoutez ce fichier à .gitignore

.gitignore recommandé

# Dépendances
/vendor/
/web/core/
/web/modules/contrib/
/web/themes/contrib/
/web/profiles/contrib/

# Fichiers générés
/web/sites/default/files/
/web/sites/default/settings.local.php

# IDE
.idea/
.vscode/

# OS
.DS_Store
Thumbs.db

# DDEV
.ddev/.gitignore

🏗️ Structure d’un module custom

web/modules/custom/tailstore_custom/
├── tailstore_custom.info.yml      # Métadonnées
├── tailstore_custom.module        # Hooks
├── tailstore_custom.routing.yml   # Routes
├── tailstore_custom.services.yml  # Services
├── src/
│   ├── Controller/
│   │   └── CartController.php
│   ├── Form/
│   │   └── SearchForm.php
│   └── Service/
│       └── CartService.php
├── templates/
│   └── cart-dropdown.html.twig
└── css/
    └── styles.css

🎨 Structure d’un thème custom

web/themes/custom/tailstore/
├── tailstore.info.yml           # Métadonnées
├── tailstore.libraries.yml      # CSS/JS
├── tailstore.theme              # Hooks de thème
├── logo.svg                     # Logo
├── screenshot.png               # Capture d'écran
├── templates/
│   ├── layout/
│   │   └── page.html.twig
│   ├── node/
│   │   └── node--product.html.twig
│   └── views/
│       └── views-view--products.html.twig
├── css/
│   ├── styles.css
│   └── custom.css
└── js/
    └── script.js

🌍 Multisite Drupal

Concept

Le multisite est une fonctionnalité Drupal permettant de servir plusieurs sites avec une seule installation Drupal. Chaque site peut avoir :

• Sa propre base de données
• Ses propres modules et thèmes activés
• Sa propre configuration
• Son propre système de fichiers

Structure multisite

web/sites/
├── sites.php              # Détermination du site
├── default/               # Site principal
│   ├── settings.php
│   ├── services.yml
│   └── files/
├── site1.local/           # Deuxième site
│   ├── settings.php
│   ├── services.yml
│   └── files/
└── site2.com/             # Troisième site
    ├── settings.php
    ├── services.yml
    └── files/

Comment ça marche ?

1. Détermination du site : Le fichier sites.php vérifie le domaine/host de la requête
2. Configuration par site : Chaque dossier sites/<nom>/ contient sa propre configuration
3. Base de données dédiée : settings.php spécifie quelle BDD utiliser
4. Isolation : Les fichiers uploadés sont isolés par site

Exemple de sites.php

<?php

// Détermination automatique basée sur le domaine HTTP_HOST
$sites = [
    'site1.local' => 'site1.local',
    'www.site1.local' => 'site1.local',
    'site2.com' => 'site2.com',
    'www.site2.com' => 'site2.com',
];

if (isset($sites[$_SERVER['HTTP_HOST']])) {
    $site_dir = $sites[$_SERVER['HTTP_HOST']];
}

Exemple de settings.php (site1.local)

<?php

// Configuration spécifique au site 1
$databases['default']['default'] = [
    'database' => 'site1_db',
    'username' => 'db_user',
    'password' => 'db_pass',
    'host' => 'db',
    'driver' => 'mysql',
];

$settings['config_sync_directory'] = '../../config/site1';

Avantages

✅ Une seule installation Drupal à maintenir ✅ Mises à jour simplifiées pour tous les sites ✅ Économies de ressources serveur ✅ Gestion centralisée des modules

Limitations

⚠️ Plus complexe à configurer ⚠️ Modules activés globalement (même si différentes configurations) ⚠️ Performance : une seule instance PHP pour tous les sites ⚠️ Peu utilisé en production (préférence pour instances séparées)

Cas d’usage

Le multisite est généralement utilisé pour :

• Réseaux de sites : Agences avec plusieurs clients
• Localisation : Un site par langue avec contenu partagé
• Prototypes : Tester plusieurs configurations du même site

Pour la plupart des projets : Une instance Drupal = un domaine. C’est plus simple et plus robuste.

🔍 Où trouver quoi ?

Je cherche…	Emplacement
La config de mon site	config/sync/system.site.yml
Un type de contenu	config/sync/node.type.*.yml
Les champs d’un contenu	config/sync/field.field.node.*.yml
Une vue	config/sync/views.view.*.yml
Les modules installés	web/modules/contrib/
Mon module custom	web/modules/custom/
Mon thème	web/themes/custom/
Les fichiers uploadés	web/sites/default/files/
La configuration PHP	web/sites/default/settings.php

✅ Exercice pratique

1. Explorez la structure de votre projet :

   # Lister les dossiers principaux
   ls -la
   ls -la web/
   ls -la web/modules/

2. Créez les dossiers pour vos futurs modules et thèmes :

   mkdir -p web/modules/custom
   mkdir -p web/themes/custom

3. Vérifiez que le dossier de configuration existe :

   ls -la config/sync/

🚀 Étape suivante

Passez à la Configuration Sync pour maîtriser l’import/export de configuration.