Installation avec Composer

Composer est le gestionnaire de dépendances standard pour PHP. C’est l’outil obligatoire pour installer et maintenir un projet Drupal 11 moderne.

🤔 Pourquoi Composer ?

Avant Composer (Drupal 7 et avant)

❌ Téléchargement manuel des modules depuis drupal.org
❌ Gestion manuelle des mises à jour
❌ Conflits de dépendances fréquents
❌ Pas de versionnement des dépendances

Avec Composer (Drupal 8+)

✅ Installation automatique des modules et leurs dépendances
✅ Mises à jour simples avec une seule commande
✅ Versions verrouillées dans composer.lock
✅ Reproducibilité parfaite entre environnements
✅ Autoloading PSR-4 automatique

📦 Les fichiers Composer

composer.json

Le fichier de configuration principal qui décrit votre projet :

{
    "name": "drupal/recommended-project",
    "description": "Project template for Drupal projects",
    "type": "project",
    "license": "GPL-2.0-or-later",
    "require": {
        "drupal/core-recommended": "^11.0",
        "drupal/core-composer-scaffold": "^11.0",
        "drush/drush": "^13.0"
    },
    "require-dev": {
        "drupal/core-dev": "^11.0"
    },
    "extra": {
        "drupal-scaffold": {
            "locations": {
                "web-root": "web/"
            }
        },
        "installer-paths": {
            "web/core": ["type:drupal-core"],
            "web/modules/contrib/{$name}": ["type:drupal-module"],
            "web/themes/contrib/{$name}": ["type:drupal-theme"],
            "web/profiles/contrib/{$name}": ["type:drupal-profile"]
        }
    }
}

Sections importantes

Section	Description
`require`	Dépendances de production
`require-dev`	Dépendances de développement uniquement
`extra.installer-paths`	Où installer les packages Drupal
`extra.drupal-scaffold`	Configuration du scaffolding

composer.lock

Fichier généré automatiquement qui verrouille les versions exactes de toutes les dépendances.

🛠️ Commandes Composer essentielles

Créer un nouveau projet

composer create-project drupal/recommended-project:^11.0 mon-projet

drupal/recommended-project : Template officiel Drupal
^11.0 : Version 11.x (dernière version 11)

Installer les dépendances

# Installer depuis composer.lock (recommandé en production)
composer install

# Mettre à jour les dépendances selon composer.json
composer update

Ajouter un module

# Ajouter un module Drupal
composer require drupal/pathauto

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

# Ajouter en dev uniquement
composer require --dev drupal/devel

Mettre à jour

# Mettre à jour tout
composer update

# Mettre à jour un package spécifique
composer update drupal/core-recommended --with-dependencies

# Voir les mises à jour disponibles
composer outdated

Supprimer un package

composer remove drupal/pathauto

Commandes utiles

# Afficher les packages installés
composer show

# Afficher un package spécifique
composer show drupal/core

# Vérifier les problèmes
composer diagnose

# Vider le cache Composer
composer clear-cache

🔒 Versionnement sémantique

Composer utilise le versionnement sémantique :

MAJOR.MINOR.PATCH
  11  .  0  .  1

Préfixe	Signification	Exemple
`^`	Compatible MAJOR	`^11.0` → 11.x.x
`~`	Compatible MINOR	`~11.0.1` → 11.0.x
`>=`	Version minimale	`>=11.0`
`*`	N’importe quelle version	Non recommandé

📁 Structure après installation

tailstore/
├── composer.json         # Configuration du projet
├── composer.lock         # Versions verrouillées
├── vendor/               # Dépendances (NE PAS MODIFIER)
│   ├── autoload.php     # Autoloader généré
│   ├── composer/
│   ├── drupal/
│   └── ...
├── web/                  # Racine web
│   ├── core/            # Drupal core
│   ├── modules/
│   │   ├── contrib/     # Modules téléchargés
│   │   └── custom/      # Vos modules
│   ├── themes/
│   │   ├── contrib/     # Thèmes téléchargés
│   │   └── custom/      # Vos thèmes
│   └── sites/
└── config/
    └── sync/            # Configuration exportée

🎯 Installer les modules essentiels

Pour notre projet TailStore, installons les modules de base :

# Dans le dossier du projet
cd tailstore

# Modules contributifs essentiels
composer require drupal/admin_toolbar
composer require drupal/pathauto
composer require drupal/token
composer require drupal/webform
composer require drupal/metatag

# Module de développement
composer require --dev drupal/devel

🔄 Workflow quotidien

Récupérer le code (si vous travaillez en équipe)
Fenêtre de terminal
```
git pull
composer install
drush updb -y
drush cim -y
drush cr
```

Ajouter une fonctionnalité

composer require drupal/nouveau_module
drush en nouveau_module -y
drush cex -y
git add -A
git commit -m "feat: add nouveau_module"

Mettre à jour Drupal

composer update drupal/core-recommended --with-dependencies
drush updb -y
drush cr
# Tester le site
git add -A
git commit -m "chore: update Drupal core"

⚠️ Bonnes pratiques

À faire ✅

Commiter composer.json ET composer.lock
Utiliser composer install en production
Verrouiller les versions majeures (^11.0)
Tester après chaque composer update

À éviter ❌

Ne jamais modifier les fichiers dans vendor/
Ne pas commiter le dossier vendor/
Ne pas utiliser composer update en production
Ne pas mélanger téléchargements manuels et Composer

🐛 Résolution de problèmes

Conflit de dépendances

# Voir les conflits
composer why-not drupal/some-module

# Forcer une mise à jour
composer update --with-all-dependencies

Mémoire insuffisante

# Augmenter la limite mémoire pour cette commande
php -d memory_limit=-1 /usr/local/bin/composer update

Cache corrompu

composer clear-cache
rm -rf vendor
composer install

✅ Exercice pratique

Installez les modules suivants avec Composer :

drupal/admin_toolbar - Barre d’administration améliorée
drupal/pathauto - URLs automatiques
drupal/token - Jetons pour pathauto
drupal/metatag - Méta-tags SEO

Commandes :

composer require drupal/admin_toolbar drupal/pathauto drupal/token drupal/metatag

Vérifiez avec :

composer show drupal/*

🔤 Comprendre le PSR-4

Le PSR-4 (PHP Standard Recommendation 4) est une norme qui définit comment charger automatiquement les classes PHP. Au lieu d’utiliser require() ou include() manuellement, le PSR-4 permet à Composer de charger les classes automatiquement en fonction de leur namespace.

Avant (sans Composer/PSR-4)

require_once 'includes/MyClass.php';
$obj = new MyClass();

Avec Composer et PSR-4

// Composer charge automatiquement MyClass via vendor/autoload.php
$obj = new MyClass();

Le fichier vendor/autoload.php généré par Composer gère toute cette magie. C’est pourquoi il est essentiel de l’inclure dans le point d’entrée de votre application.

Pour plus de détails, consultez:

PSR-4 sur PHP-FIG - La spécification officielle
Autoloading dans la documentation Composer

🚀 Étape suivante

Passez à la Structure des fichiers pour comprendre l’organisation d’un projet Drupal.