Actu Smile

Migration Drupal 10 : étapes, outils et bonnes pratiques

  • Date de l’événement 21 Sep. 2026
  • Temps de lecture min.

Audit, 6R, Terraform, FinOps, souveraineté : planifiez votre migration cloud vers AWS avec méthode. Retours d'expérience et expertise reconnue par Smile.

Drupal 9 est en fin de vie depuis novembre 2023. Drupal 8 l'est depuis novembre 2021. Les sites qui n'ont pas encore migré sont exposés à des failles de sécurité non corrigées. C'est un risque réel pour les données et la continuité de service.

La migration Drupal 10 n'est pas optionnelle. Mais bien préparée, elle est aussi une opportunité. C'est le bon moment pour moderniser l'architecture, améliorer les performances et adopter une approche headless.

Ce guide vous explique ce qui change, les étapes à suivre et les erreurs à éviter.

Qu'est-ce que Drupal et pourquoi migrer vers Drupal 10 ?

Un CMS (Content Management System) est un système de gestion de contenu. Il permet à des équipes éditoriales de créer et publier du contenu sans compétences techniques.

Drupal est un CMS open source. Il est utilisé par des organisations qui ont des besoins complexes : sites multilingues, gestion de droits avancée, architecture multisite, intégrations multiples. C'est le CMS de référence pour les grandes organisations publiques et privées en France.

Pourquoi migrer maintenant ?

Drupal 8 et 9 ne reçoivent plus de mises à jour de sécurité. Un site non migré est vulnérable. Les failles découvertes après la fin de vie ne sont pas corrigées. C'est une exposition directe aux cyberattaques.

Les nouveautés de Drupal 10

Drupal 10 apporte des améliorations significatives. L'interface d'administration est modernisée. Les performances sont améliorées. Le support des nouvelles technologies PHP et Symfony est intégré nativement.

Ce qui change dans Drupal 10

PHP 8.1 minimum

Drupal 10 nécessite PHP 8.1 au minimum. PHP 8.1 est plus rapide et plus sécurisé que les versions précédentes. Les serveurs qui tournent encore sur PHP 7 ou PHP 8.0 doivent être mis à jour avant la migration.

 

Symfony 6

Drupal utilise des composants du framework Symfony. Symfony est un ensemble d'outils PHP réutilisables. Drupal 10 intègre Symfony 6, une version plus récente et plus performante. Les modules qui dépendent d'anciennes versions de Symfony doivent être mis à jour.

 

CKEditor 5

CKEditor est l'éditeur de texte utilisé dans le back-office Drupal. La version 5 remplace la version 4. L'interface est plus moderne. Les fonctionnalités d'édition sont améliorées. Certains plugins CKEditor 4 personnalisés doivent être réécrits.

 

Olivero et Claro : les nouveaux thèmes

Olivero est le nouveau thème frontend par défaut. Claro est le nouveau thème d'administration. Les deux sont accessibles et conformes aux standards modernes. Les thèmes personnalisés existants doivent être adaptés.

 

Suppression des modules dépréciés

Plusieurs modules présents dans Drupal 9 ont été supprimés dans Drupal 10. Aggregator, Color, RDF, Quick Edit et Seven en font partie. Les sites qui utilisent ces modules doivent trouver des alternatives avant de migrer.

Les étapes d'une migration Drupal 10 réussie

Étape 1 : Auditer l'existant

On commence par inventorier tous les modules installés. On vérifie leur compatibilité avec Drupal 10. On identifie les modules dépréciés et les modules sans équivalent. C'est l'étape la plus importante. Elle conditionne toute la suite.

 

Étape 2 : Mettre à jour les dépendances

On met à jour PHP, le serveur web et la base de données. On vérifie que l'environnement d'hébergement est compatible avec Drupal 10. On utilise Composer pour gérer toutes les dépendances du projet.

 

Étape 3 : Migrer les modules contrib

Les modules contrib sont des modules créés par la communauté Drupal. Certains sont déjà compatibles Drupal 10. D'autres sont encore en cours de mise à jour. Pour les modules sans version compatible, on cherche des alternatives ou on développe une solution sur mesure.

 

Étape 4 : Adapter les thèmes

Le thème frontend et le thème d'administration doivent être mis à jour. Les templates Twig (Twig est le langage de templating de Drupal) doivent être vérifiés. Les styles CSS et les scripts JavaScript doivent être testés.

 

Étape 5 : Tester et recetter

On teste toutes les fonctionnalités du site. Les formulaires, les workflows éditoriaux, les intégrations tierces, les performances. On implique les équipes éditoriales dans la recette. Elles connaissent les parcours métier mieux que les développeurs.

 

Étape 6 : Mettre en production

On planifie la mise en production en dehors des heures de pointe. On prépare un plan de rollback (retour arrière) en cas de problème. On monitore le site pendant les premières heures après la bascule.

Les outils indispensables

Composer : gérer les dépendances

Composer est le gestionnaire de dépendances PHP. Il installe et met à jour tous les modules et bibliothèques du projet. Il est indispensable pour une migration Drupal 10 propre.

 

Upgrade Status : vérifier la compatibilité

Upgrade Status est un module Drupal. Il analyse tous les modules installés et indique leur niveau de compatibilité avec Drupal 10. C'est le premier outil à installer avant de commencer la migration.

 

Drush : l'outil en ligne de commande

Drush est l'outil CLI (interface en ligne de commande) de Drupal. Il permet d'exécuter des opérations de maintenance, de mettre à jour la base de données et de vider les caches. Il est indispensable pour automatiser les tâches répétitives de la migration.

 

phpcs : vérifier la qualité du code

phpcs (PHP CodeSniffer) analyse le code PHP personnalisé. Il détecte les incompatibilités avec Drupal 10. Il est particulièrement utile pour les projets avec beaucoup de développements sur mesure.

Migration vers Drupal 10 headless

Pourquoi adopter le headless en migrant

La migration est le bon moment pour évaluer une architecture headless. Un CMS headless expose le contenu via des APIs. Le frontend est développé séparément. C'est plus flexible et plus performant.

Drupal 10 supporte nativement le headless. JSON:API et GraphQL sont intégrés sans module supplémentaire. C'est une évolution naturelle pour les organisations qui veulent distribuer leur contenu sur plusieurs canaux.

 

Intégration avec les frameworks frontend

Drupal 10 s'intègre nativement avec Next.js et Nuxt.js. Ces frameworks consomment le contenu Drupal via les APIs. Le rendu côté serveur (SSR) garantit d'excellentes performances et un bon référencement naturel.

Les erreurs courantes à éviter

Sous-estimer les modules incompatibles

C'est l'erreur la plus fréquente. Certains modules contrib n'ont pas encore de version compatible Drupal 10. Les identifier trop tard bloque la migration. L'audit des modules doit être la toute première étape.

 

Négliger les tests de régression

Un test de régression vérifie que les fonctionnalités existantes fonctionnent toujours après la migration. Sans tests structurés, des bugs passent en production. Ils impactent les utilisateurs et les équipes éditoriales.

 

Migrer sans plan de rollback

Si quelque chose se passe mal en production, il faut pouvoir revenir en arrière rapidement. Un plan de rollback est indispensable. Il doit être testé avant la mise en production.

Smile et Drupal : notre expertise

Chez Smile, nous accompagnons la migration Drupal 10 depuis les premières versions bêta du CMS. Nous sommes l'un des intégrateurs Drupal les plus reconnus en France. Nous avons migré des dizaines de sites complexes : portails institutionnels, plateformes e-commerce, sites multisites et architectures headless.

Notre approche commence toujours par un audit complet. On identifie les risques. On planifie la migration par étapes. On garantit la continuité de service pendant la transition.

Vous souhaitez planifier votre migration Drupal ? Découvrez notre expertise pour migrer vers Drupal 10.

Questions fréquentes sur la migration Drupal 10

Mon site est encore sur Drupal 7. Que faire ?

Drupal 7 a atteint sa fin de vie en janvier 2025. La migration directe vers Drupal 10 n'est pas possible techniquement. Il faut passer par une migration de contenu avec le module Migrate. C'est un projet plus complexe qu'une montée de version depuis Drupal 9. Il nécessite une analyse approfondie et une planification rigoureuse.

 

Combien de temps prend une migration Drupal 10 ?

Cela dépend de la complexité du site. Un site avec peu de modules contrib et pas de développements sur mesure peut migrer en quelques semaines. Un site complexe avec beaucoup de modules personnalisés et une architecture multisite peut nécessiter plusieurs mois. L'audit initial donne une estimation fiable.

 

Peut-on migrer vers Drupal 10 sans interruption de service ?

Oui, avec une bonne préparation. On travaille sur un environnement de staging (environnement de test identique à la production). On bascule en production lors d'une fenêtre de maintenance courte. Avec un bon plan de rollback, le risque d'interruption prolongée est très faible.

 

Drupal 10 est-il adapté au headless ?

Oui. Drupal 10 est l'un des CMS les mieux adaptés au headless parmi les solutions open source. JSON:API est intégré nativement. GraphQL est disponible via un module maintenu. La migration vers Drupal 10 est une bonne occasion d'évaluer une architecture headless pour distribuer le contenu sur plusieurs canaux.