Gestion des Modules

📦 Installation avec Composer

Pourquoi Composer ?

Composer est le gestionnaire de dépendances PHP standard depuis Drupal 8. Il :

• ✅ Gère les dépendances automatiquement (si module A nécessite B, les deux sont installés)
• ✅ Garantit la cohérence des versions entre les environnements
• ✅ Facilite les mises à jour et les rollbacks
• ✅ Génère l’autoloading PHP optimisé
• ✅ Sécurise les installations (vérification de l’intégrité)

Important

N’installez jamais de modules manuellement en téléchargeant depuis drupal.org. Utilisez toujours Composer.

Pourquoi ?

• ❌ Pas de gestion des dépendances
• ❌ Conflits de versions possibles
• ❌ Pas de traçabilité (composer.json/lock)
• ❌ Complexifie les déploiements

Bonne pratique : Workflow d’installation

Process professionnel

1. Installer avec Composer : composer require drupal/module
2. Activer avec Drush : drush en module -y
3. Configurer via l’interface ou Drush
4. Exporter la configuration : drush cex -y
5. Commiter : git add composer.json composer.lock config/ puis git commit

Ce workflow garantit la reproductibilité sur tous les environnements.

Commandes essentielles

# Rechercher un module
ddev composer search drupal/pathauto

# Voir les infos d'un module
ddev composer show drupal/pathauto --all

# Installer un module
ddev composer require drupal/pathauto

# Installer une version spécifique
ddev composer require drupal/pathauto:^1.12

# Désinstaller un module
ddev composer remove drupal/pathauto

🔌 Activation avec Drush

Activer un module

# Activer un module
ddev drush en pathauto -y

# Activer plusieurs modules
ddev drush en pathauto metatag webform -y

# Vérifier le statut
ddev drush pm:list --filter=pathauto

Désactiver un module

# Désinstaller (désactive + supprime config)
ddev drush pm:uninstall pathauto -y

# Puis supprimer les fichiers
ddev composer remove drupal/pathauto

Ordre important

Pour désinstaller : d’abord drush pm:uninstall, puis composer remove.

📋 Liste des modules

Voir tous les modules

# Tous les modules
ddev drush pm:list

# Modules activés
ddev drush pm:list --status=enabled

# Modules désactivés
ddev drush pm:list --status=disabled

# Filtrer par nom
ddev drush pm:list --filter=token

Format tableau

ddev drush pm:list --format=table

Exemple de sortie :

+-------------------+-------------------+--------+---------+
| Package           | Name              | Status | Version |
+-------------------+-------------------+--------+---------+
| Core              | node              | Enabled| 11.1.0  |
| Core              | views             | Enabled| 11.1.0  |
| Token             | token             | Enabled| 1.15.0  |
| Pathauto          | pathauto          | Enabled| 1.13.0  |
+-------------------+-------------------+--------+---------+

🔄 Mises à jour

Vérifier les mises à jour disponibles

# Voir les modules outdated
ddev composer outdated drupal/*

# Version détaillée
ddev composer outdated drupal/* --direct

Appliquer une mise à jour

1. Mettre à jour avec Composer

   ddev composer update drupal/pathauto --with-dependencies

2. Exécuter les mises à jour de base de données

   ddev drush updatedb -y

3. Vider le cache

   ddev drush cr

4. Exporter la configuration

   ddev drush cex -y

Mise à jour globale

# Mettre à jour tous les modules Drupal
ddev composer update drupal/* --with-dependencies
ddev drush updatedb -y
ddev drush cr
ddev drush cex -y

🔒 Vérification de sécurité

Audit des vulnérabilités

# Vérifier les failles connues
ddev composer audit

# Format JSON pour CI/CD
ddev composer audit --format=json

Alertes de sécurité Drupal

# Dans l'interface admin
# Rapports → Mises à jour disponibles → Onglet Sécurité

📁 Structure des fichiers

Après installation

web/modules/
├── contrib/                    # Modules contributifs
│   ├── pathauto/
│   │   ├── pathauto.info.yml
│   │   ├── pathauto.module
│   │   └── ...
│   └── metatag/
│       └── ...
└── custom/                     # Vos modules
    └── tailstore_cart/

Fichier composer.json

{
    "require": {
        "drupal/core-recommended": "^11.1",
        "drupal/pathauto": "^1.13",
        "drupal/metatag": "^2.0",
        "drupal/webform": "^6.2",
        "drupal/admin_toolbar": "^3.5",
        "drupal/token": "^1.15"
    }
}

Fichier composer.lock

Le composer.lock verrouille les versions exactes. Commitez-le toujours !

git add composer.lock
git commit -m "chore: update dependencies"

⚙️ Configuration des modules

Exporter après configuration

# Exporter toute la config
ddev drush cex -y

# Voir les fichiers créés
ls -la config/sync/

Importer la configuration

# Sur un autre environnement
ddev drush cim -y

🧪 Environnement de développement

Modules de dev

# Installer les modules de dev
ddev composer require --dev drupal/devel drupal/webprofiler

# Activer
ddev drush en devel webprofiler -y

--dev

Utilisez --dev pour les modules de développement. Ils ne seront pas déployés en production.

Activer uniquement en local

Dans settings.local.php :

// Activer les modules de dev
$config['devel']['disable'] = FALSE;

// OU avec drush seulement en local
// ddev drush en devel -y

📊 Dépendances

Voir l’arbre de dépendances

# Dépendances d'un module
ddev composer depends drupal/token

# Pourquoi un package est installé
ddev composer why drupal/ctools

Conflits de versions

# Voir les conflits
ddev composer why-not drupal/pathauto:^2.0

✅ Checklist

• Composer configuré et fonctionnel
• Modules installés via Composer
• Drush disponible pour activation
• Mises à jour vérifiées
• Configuration exportée
• composer.lock commité

🔜 Prochaine étape

Les bases sont en place ! Configurons Pathauto pour des URLs automatiques.