Migration Drupal 7 vers 11 : le guide complet

Drupal 7 a été une version exceptionnelle. Sortie en 2011, elle a propulsé des milliers de sites pendant plus d'une décennie. Mais toutes les bonnes choses ont une fin : le support officiel de Drupal 7 s'est arrêté en janvier 2025.

Si votre site tourne encore sur Drupal 7, vous êtes en zone de risque. Voici notre guide complet pour réussir votre migration vers Drupal 11.

Pourquoi migrer de toute urgence ?

Support de sécurité terminé

Depuis janvier 2025, Drupal 7 ne reçoit plus de mises à jour de sécurité officielles. Chaque faille découverte devient une porte ouverte pour les attaquants. Votre site est vulnérable.

Dette technique croissante

Drupal 7 utilise PHP 7.4 (lui-même en fin de vie) et des paradigmes de développement datés. Trouver des développeurs compétents devient de plus en plus difficile et coûteux.

Fonctionnalités modernes

Drupal 11 apporte des améliorations majeures :

• Performance : rendering optimisé, BigPipe, lazy loading natif
• Éditeur de contenu : CKEditor 5, Layout Builder, Experience Builder
• API : JSON:API en core, découplage facilité
• Accessibilité : conformité WCAG 2.1 AA dès l'installation

État des versions Drupal en 2026

Le calendrier des versions Drupal pèse directement sur votre décision de migration. Drupal 7 (sorti en 2011) a vu son support officiel se terminer en janvier 2025, avec une extension communautaire via Tag1 jusqu'à 2028 maximum. Drupal 8 n'est plus supporté depuis 2021, Drupal 9 a atteint sa fin de vie en novembre 2023, et Drupal 10 arrive en fin de vie en décembre 2026 avec la sortie de Drupal 12. La version 11, sortie en août 2024, est désormais la cible stable pour tout nouveau projet.

Si votre site est encore sur Drupal 7, vous êtes donc face à un choix clair : migrer vers Drupal 11 maintenant, ou payer un mainteneur en support étendu jusqu'au moment où il deviendra impossible de trouver des compétences. La seconde option n'est viable que pour des sites en sommeil destinés à être remplacés à court terme.

Les trois approches de migration

Avant d'entrer dans les étapes techniques, il faut choisir l'approche stratégique. Le terme « migration » recouvre en réalité trois scénarios distincts, chacun avec ses contraintes et ses avantages.

Migration complète (D7 vers D11)

C'est l'approche standard pour Drupal 7. Il n'existe pas de chemin d'upgrade direct depuis Drupal 7 vers les versions modernes : Drupal 8 a marqué une rupture architecturale (passage à Symfony, services, configuration moderne). Vous installez un Drupal 11 vierge, vous reconstruisez l'architecture éditoriale, vous migrez les contenus via la Migrate API. C'est plus engageant, mais aussi plus libérateur : tout ce qui était sale ou hérité dans l'ancien site disparaît.

Upgrade in-place (D9 ou D10 vers D11)

Pour les sites déjà sur Drupal 9 ou 10, c'est un upgrade in-place. La base de données et les contenus restent en place. On met à jour les dépendances Composer, on remplace les API dépréciées (Rector aide beaucoup ici), on teste, on déploie. C'est typiquement un chantier de quelques jours à quelques semaines, pas de plusieurs mois.

Reconstruction complète

C'est l'occasion de tout refondre : nouvelle architecture éditoriale, nouveau thème, nouveaux workflows. La migration de contenu est plus sélective (on choisit ce qu'on garde). C'est l'approche la plus longue mais aussi celle qui résout le plus de dette technique d'un coup. Recommandée quand le site Drupal 7 est devenu structurellement illisible.

Notre page migration Drupal détaille la méthodologie globale, et la plupart des projets que nous menons combinent ces approches selon les sections du site.

Les étapes d'une migration réussie

1. Audit de l'existant

Avant de migrer, il faut comprendre ce qu'on migre :

• Inventaire des modules : listez tous les modules contrib et custom
• Analyse des contenus : types de contenus, champs, taxonomies, médias
• Intégrations : CRM, ERP, services tiers
• Personnalisations : thème custom, hooks, altérations

# Lister les modules activés
drush pm:list --status=enabled

2. Choix de la stratégie

Deux approches principales :

Migration in-place (rare)

• Mise à jour progressive via Drupal 8, 9, 10, puis 11
• Possible techniquement mais rarement recommandée
• Accumule les problèmes de compatibilité

Reconstruction + migration de contenu (recommandée)

• Nouveau site Drupal 11 propre
• Migration du contenu via l'API Migrate
• Opportunité de nettoyer et moderniser

3. Préparation du nouveau site

Sur Drupal 11 :

• Installez le core et les modules contrib nécessaires
• Recréez la structure de contenu (types, champs, taxonomies)
• Développez le nouveau thème
• Configurez les permissions et workflows

4. Migration du contenu

Drupal dispose d'un système de migration puissant et flexible :

# Exemple de migration d'articles
id: upgrade_d7_node_article
label: 'Articles from Drupal 7'
migration_tags:
  - Drupal 7
  - Content
source:
  plugin: d7_node
  node_type: article
process:
  nid: nid
  title: title
  body: body
  created: created
  changed: changed
destination:
  plugin: 'entity:node'
  default_bundle: article

5. Redirection et SEO

Critique pour ne pas perdre votre référencement :

• Mapping d'URL : cartographiez les anciennes URL vers les nouvelles
• Redirections 301 : configurez les redirections permanentes
• Sitemap : générez un nouveau sitemap.xml
• Search Console : informez Google du changement

6. Tests et validation

• Tests fonctionnels sur tous les parcours utilisateur
• Vérification des migrations de contenu
• Tests de performance
• Audit SEO comparatif

Les outils indispensables

Migrate API (core)

Le système de migration de Drupal, directement en core depuis Drupal 8.

Migrate Upgrade

Module qui analyse votre site Drupal 7 et génère les fichiers de migration.

drush migrate:upgrade --legacy-db-key=drupal7 --configure-only

Migrate Tools

Outils drush pour exécuter et gérer les migrations.

drush migrate:import --group=migrate_drupal_7

Upgrade Status

Analyse la compatibilité de vos modules custom avec Drupal 11.

Rector pour Drupal

Outil d'analyse et de réécriture automatique de code PHP. Drupal Rector fournit un set de règles qui automatise la majorité des modifications nécessaires pour passer aux nouvelles API. Ne fait pas tout, mais ce qui reste manuel est plus ciblé et plus rapide.

composer require palantirnet/drupal-rector --dev
vendor/bin/rector process web/modules/custom

PHPStan et Drupal Check

Analyse statique du code pour détecter les API dépréciées, les types incorrects, les bugs potentiels. Drupal Check est une couche au-dessus de PHPStan avec les règles spécifiques Drupal préconfigurées. Indispensable pour évaluer la dette technique avant migration et valider le code custom porté.

Estimation réaliste de timeline

La durée d'une migration Drupal 7 vers 11 varie énormément selon la complexité du site. Voici des fourchettes basées sur nos projets récents.

Petit site éditorial : 10 à 20 types de contenu, 5 à 10 modules contribués, 1 à 2 modules custom légers. Comptez 4 à 8 semaines de travail effectif, incluant audit, développement, migration de contenu et tests.

Site institutionnel moyen : 20 à 40 types de contenu, 15 à 25 modules contribués, plusieurs modules custom avec intégrations externes (CRM, SSO, GED). Comptez 2 à 4 mois, parfois plus selon la complexité des intégrations.

Site complexe : multisite Drupal, e-commerce avec Drupal Commerce, multilingue avec gros volumes de traduction, intégrations ERP/PIM lourdes. Comptez 4 à 8 mois, voire plus si une refonte fonctionnelle est combinée à la migration.

Ces fourchettes supposent une équipe compétente travaillant à temps plein. Si la migration est faite par une équipe interne en parallèle d'autres projets, multipliez par 1,5 à 2.

Les pièges courants spécifiques à Drupal 7

Au-delà des erreurs classiques de migration, voici les pièges spécifiques que nous rencontrons régulièrement sur les projets Drupal 7 vers 11.

Modules custom non portés. Les modules custom écrits il y a 8 ou 10 ans utilisent souvent des API hook très anciennes, parfois non documentées. Le portage demande une vraie analyse, pas juste un Rector aveugle.

Modules contrib sans version D11. Vérifier la compatibilité de chaque module contribué avec Drupal 11 dès le début. Si un module essentiel n'a pas de version D11 et n'est plus maintenu, il faut décider tôt : alternative, fork ou abandon de la fonctionnalité.

Formats de texte et médias. Drupal 7 avait des formats de texte parfois exotiques (BBCode, Markdown via modules tiers). Drupal 11 utilise CKEditor 5. La migration des contenus rich text doit être validée manuellement sur un échantillon.

Multilingue. Drupal 7 gérait le multilingue via une mosaïque de modules (i18n, Entity Translation, Locale). Drupal 11 a un système unifié plus propre. La migration des traductions est souvent le poste le plus complexe.

Perte de redirections. Si vous utilisez le module Redirect en Drupal 7, ses entrées doivent être migrées explicitement. Une migration sans préservation des redirections existantes peut casser des liens externes (campagnes email, newsletters, signets utilisateurs).

Un audit Drupal initial cartographie tous ces points avant le projet de migration, ce qui évite les mauvaises surprises en cours de route.

Profiter de la migration pour intégrer l'IA

Drupal 11 ouvre une porte que Drupal 7 fermait : l'intégration native de l'intelligence artificielle. Le module AI Core et son écosystème (AI Search, AI CKEditor, AI Assistants, AI TMGMT) exigent Drupal 10.4 ou Drupal 11 minimum. Migrer, c'est donc aussi se rendre éligible à ces capacités.

Plutôt que de migrer aujourd'hui et d'intégrer l'IA dans un an, beaucoup de projets bénéficient de combiner les deux chantiers : la migration installe les bases techniques, et certaines fonctionnalités IA sont déployées dans la foulée. Recherche sémantique pour remplacer la recherche Solr ou ElasticSearch classique, génération de contenu assistée pour les rédacteurs, chatbot documentaire pour le support utilisateur. Voir notre page Intégration IA dans Drupal pour les cas d'usage concrets.

Les erreurs courantes à éviter

1. Sous-estimer la complexité

Une migration n'est pas une mise à jour. C'est un projet à part entière qui demande planification, ressources et tests.

2. Migrer les problèmes

La migration est l'occasion de nettoyer : contenus obsolètes, modules inutilisés, configurations abandonnées. Ne migrez pas la dette technique.

3. Oublier le SEO

Les redirections 301 sont cruciales. Un site migré sans redirections peut perdre 50% de son trafic organique.

4. Négliger les tests

Testez chaque type de contenu, chaque fonctionnalité, chaque intégration. Les surprises arrivent toujours en production.

5. Faire cavalier seul

La migration Drupal 7 → 11 est technique. Si vous n'avez pas l'expertise en interne, faites appel à des spécialistes.

FAQ

Combien de temps dure une migration ?

Ça dépend de la taille et de la complexité du site. Un site simple : quelques semaines. Un site complexe avec beaucoup de contenu et d'intégrations : plusieurs mois.

Peut-on migrer progressivement ?

Oui. On peut migrer le contenu par lots, commencer par les contenus prioritaires et faire des mises à jour incrémentales.

Que faire des modules sans équivalent Drupal 11 ?

Trois options :

1. Trouver un module alternatif avec des fonctionnalités similaires
2. Développer un module custom
3. Abandonner la fonctionnalité si elle n'est plus pertinente

Le contenu est-il préservé ?

Oui, si la migration est bien configurée. Le système Migrate permet de mapper précisément les champs source vers les champs destination.

Conclusion

La migration de Drupal 7 vers 11 est un investissement, mais c'est aussi une opportunité : moderniser votre stack technique, améliorer l'expérience utilisateur et bénéficier des fonctionnalités modernes de Drupal.

Chaque jour compte. Votre site Drupal 7 est exposé aux failles de sécurité non corrigées. Plus vous agissez vite, moins vous risquez d'incident.

---

Besoin d'aide pour votre migration ? Nos experts Drupal accompagnent des projets de migration depuis des années. Parlons de votre projet.