Blog

Avec la sortie de Drupal 11, de nombreuses entreprises et organisations utilisant Drupal 9 ou Drupal 10 doivent envisager une migration afin de bénéficier des dernières avancées en matière de performance, sécurité et architecture applicative.

La migration vers Drupal 11 représente une étape importante pour garantir la pérennité d’un site web construit sur ce CMS open source largement utilisé par les entreprises, les institutions publiques et les plateformes digitales à fort trafic.

Pour les organisations disposant de sites complexes, cette migration doit être planifiée avec méthode. Une migration Drupal mal préparée peut entraîner des incompatibilités de modules, des erreurs dans le code personnalisé ou des interruptions de service.

Dans ce guide technique, nous allons détailler les prérequis techniques, les étapes clés et les principaux défis à anticiper pour réussir une migration vers Drupal 11.

Fullwave Agency, agence experte en développement Drupal au Maroc, accompagne régulièrement des entreprises dans leurs projets de migration Drupal, d’upgrade de core et d’optimisation de plateformes Drupal.

Pourquoi migrer vers Drupal 11 ?

La migration vers Drupal 11 permet de bénéficier des dernières évolutions du CMS Drupal et d’assurer la pérennité d’une plateforme web.

Plusieurs raisons peuvent justifier cette migration.

Amélioration des performances
Drupal 11 s’appuie sur PHP 8.3 et Symfony 7, ce qui permet d’améliorer les performances globales du système, la gestion de la mémoire et la rapidité d’exécution du code.

Renforcement de la sécurité
Les nouvelles versions de Drupal intègrent régulièrement des améliorations de sécurité. Migrer vers Drupal 11 permet de maintenir un niveau de sécurité élevé pour les applications web basées sur Drupal.

Architecture moderne
Avec Symfony 7, Drupal adopte une architecture encore plus moderne facilitant l’intégration avec des architectures headless, API-first ou microservices.

Maintenabilité à long terme
La migration vers Drupal 11 permet d’anticiper la fin de vie des versions précédentes et de maintenir une plateforme durable et évolutive.

Les prérequis techniques

Avant de lancer la moindre commande Composer, assurez-vous que votre infrastructure est prête. Drupal 11 introduit plusieurs exigences techniques importantes.

PHP 8.3+ Il s’agit du prérequis le plus important. Les versions antérieures comme PHP 8.1 ou PHP 8.2 ne sont plus supportées.

PHP 8.3 apporte notamment des améliorations de performance et introduit des fonctionnalités modernes comme les readonly classes ainsi que des optimisations du moteur JIT.

Base de données:

MySQL 8.0+
MariaDB 10.6+
PostgreSQL 16+
SQLite 3.45+

Pour les projets Drupal entreprise, la mise à niveau de la base de données peut nécessiter une planification afin de limiter l’impact sur les environnements de production.

Composer 2.7.0+:
Composer est indispensable pour gérer les dépendances d’un projet Drupal moderne. Drupal 11 nécessite Composer 2.7 ou une version supérieure.

Symfony 7:
Drupal 11 repose désormais sur Symfony 7. Cela implique des changements dans la gestion des services, des événements et de certaines signatures de méthodes.

Ces évolutions peuvent avoir un impact direct sur les modules personnalisés et le code custom Drupal.

Les phases de l’upgrade : méthodologie pas à pas

Le secret d’une migration Drupal réussie repose sur l’ordre d’exécution des étapes.

Étape 1 : le pont Drupal 10.3

Il n’est pas recommandé de passer directement de Drupal 9 ou Drupal 10.1 vers Drupal 11.

La version Drupal 10.3 constitue une étape intermédiaire importante. Elle contient toutes les API de Drupal 11 tout en conservant la compatibilité ascendante.

Cette version permet notamment d’identifier et de corriger les dépréciations avant l’upgrade final.

Étape 2 : l’audit de préparation

Installez le module Upgrade Status.

Ce module permet d’analyser votre environnement Drupal, vos modules contrib et votre code personnalisé afin d’identifier les éléments incompatibles avec Drupal 11.

Cet audit constitue une étape essentielle dans tout projet de migration Drupal.

Étape 3 : mise à jour du code Contrib et Custom

Une fois l’audit terminé, mettez à jour les modules contrib vers leurs versions compatibles avec Drupal 11.

Examinez également votre code personnalisé afin d’apporter les modifications nécessaires.

Il est recommandé d’utiliser l’outil Drupal Rector afin d’automatiser la correction des API obsolètes.

Drupal Rector permet de réécrire automatiquement le code afin qu’il utilise les nouvelles méthodes compatibles avec Drupal 11 et Symfony 7.

Étape 4 : la mise à jour du Core

Une fois la mise à jour du code terminée, vous pouvez procéder à la mise à jour du core Drupal.

Préparer les permissions
Drupal peut verrouiller certains fichiers de configuration. Il est donc nécessaire d’ouvrir les permissions pour permettre à Composer de modifier les fichiers concernés.

Mettre à jour les dépendances avec --no-update

L’utilisation du flag --no-update permet de modifier le fichier composer.json sans lancer immédiatement la résolution des dépendances.

Cela permet d’éviter de nombreux conflits potentiels.

Mettre à jour les outils de développement et Drush 13

Drupal 11 nécessite Drush 13. Il est recommandé de mettre à jour les outils de développement en parallèle.

Effectuer un test avec le dry-run

Avant d’exécuter la mise à jour, il est conseillé de simuler l’installation avec la commande :

composer update --dry-run

Si aucun conflit n’est détecté, vous pouvez lancer la commande finale :

composer update "drupal/core-*" drush/drush --with-all-dependencies

Finalisation et sécurisation

Terminez par la mise à jour de la base de données ainsi que par la restauration des permissions de sécurité.

Les principaux obstacles rencontrés

Compatibilité des modules contrib

Certains modules populaires peuvent ne pas disposer immédiatement d’une version stable compatible avec Drupal 11.

Il est recommandé de vérifier les issues sur Drupal.org. Dans de nombreux cas, des patchs de compatibilité sont disponibles.

Ces patchs peuvent être appliqués via le plugin cweagans/composer-patches.

Retrait de modules du Core

Drupal 11 continue de simplifier son core. Certains modules comme Book, Forum ou Tracker ont été retirés du cœur.

Si votre site utilise ces modules, vous devrez les installer en version contrib avant de procéder à la migration.

Dépendances Symfony 7 et Twig 3

Le passage à Symfony 7 peut impacter certains services personnalisés. De même, Twig 3 impose une syntaxe plus stricte dans les templates.

Code custom et typage PHP

Drupal 11 introduit un typage PHP plus strict. Si votre code personnalisé ne respecte pas les nouveaux types de retour, cela peut générer des erreurs fatales.

Scripts JavaScript personnalisés

Drupal 11 utilise jQuery 4. Si votre site contient des scripts JavaScript dépendants d’anciennes versions de jQuery, ils devront être adaptés.

Upgrade du moteur de base de données

La migration vers MySQL 8.0+ ou MariaDB 10.6+ peut représenter un défi technique pour certaines plateformes.

Le processus Export → Upgrade serveur → Import peut nécessiter une planification précise afin de limiter les temps d’arrêt.

Bonnes pratiques pour réussir une migration Drupal 11

Nettoyer la dette technique

Profitez de la migration pour désinstaller les modules inutilisés. Moins votre plateforme contient de code, plus la migration sera simple.

Utiliser un environnement de staging

Ne testez jamais une migration directement en production. Les changements liés aux versions de PHP et de base de données doivent être validés sur un environnement de staging.

Backup et test de restauration

La sauvegarde de la base de données est indispensable. Il est recommandé de tester la restauration du dump avant de lancer la migration.

Surveiller le fichier composer.json

Vérifiez que certaines dépendances ne sont pas verrouillées sur des versions incompatibles avec Drupal 11.

Conclusion finale

La migration vers Drupal 11 représente une étape importante pour maintenir une plateforme Drupal performante, sécurisée et évolutive.

Grâce à des outils comme Upgrade Status et Drupal Rector, le processus de migration est aujourd’hui largement simplifié.

La clé du succès reste toutefois une préparation rigoureuse, un audit technique complet et des tests approfondis avant toute mise en production.

Pour les plateformes complexes, l’accompagnement par une agence experte Drupal peut permettre de sécuriser la migration et d’optimiser les performances de la plateforme.

Fullwave Agency accompagne les entreprises dans leurs projets de migration Drupal, de développement Drupal et de modernisation de plateformes web basées sur Drupal.

Anticiper la migration vers Drupal 11 permet de préparer sereinement la fin de support de Drupal 10 prévue pour mi-2026.