
Symfony 8.2 est attendu fin novembre 2026. Drupal 12.0.0, lui, est prévu la semaine du 7 décembre. Les deux dates sont proches, et le blog Symfony publie en ce moment une série d’articles « New in Symfony 8.2 » chaque jour.
Le problème, c’est que la grande majorité de ces nouveautés concernent le framework Symfony complet (FrameworkBundle, Messenger, Forms, Security, AssetMapper…). Drupal n’utilise pas le framework : il utilise une quinzaine de composants. Lire toute la série en se demandant « qu’est-ce que ça change pour mon site Drupal ? » fait perdre beaucoup de temps.
Cet article fait le tri : le calendrier, ce qui touche réellement le code Drupal, ce que vous pouvez ignorer et ce qu’il faut faire maintenant.
Les informations viennent des notes de mise à jour de Symfony 8.2 (UPGRADE-8.2.md, version bêta au moment de l’écriture) et des branches 11.5.x et 12.0.x de Drupal core. Symfony 8.2 n’est pas encore sorti : certains détails peuvent encore bouger.
Le calendrier en un coup d’œil
| Version | Sortie | Fin de support | Utilisée par |
|---|---|---|---|
| Symfony 7.4 LTS | novembre 2025 | bugs : novembre 2028, sécurité : novembre 2029 | Drupal 11.3, 11.4, 11.5 |
| Symfony 8.1 | mai 2026 | janvier 2027 | Drupal 12.0 (bêta) |
| Symfony 8.2 | novembre 2026 | juillet 2027 | pas encore Drupal |
Deux constats :
- Drupal 11 est sur Symfony 7.4 LTS et y restera. La LTS est maintenue bien au-delà du support de Drupal 11 (prévu jusqu’à mi ou fin 2028). Pour un site Drupal 11, Symfony 8.2 ne change rien.
- Drupal 12.0 est aujourd’hui construit sur Symfony 8.1, qui n’est plus maintenu à partir de janvier 2027, soit un mois après la sortie de Drupal 12. Le passage à 8.2 est donc une question de semaines, pas d’années.
Drupal suit les versions mineures de Symfony
Ce n’est pas une supposition, c’est ce que montre l’historique de core/composer.json :
| Drupal | Symfony requis | Épinglé par drupal/core-recommended |
|---|---|---|
| 11.0.0 | ^7.1 |
~v7.1.3 |
| 11.1.0 | ^7.2 |
~v7.2.0 |
| 11.2.0 | ^7.3 |
~v7.3.0 |
| 11.3.0 | ^7.4 |
~v7.4.0 |
| 12.0.0-beta1 | ^8.1 |
~v8.1.6 |
Chaque version mineure de Drupal 11 a adopté la version mineure de Symfony suivante, jusqu’à la LTS 7.4. Drupal 12 suivra le même chemin : 8.1, puis 8.2, et ainsi de suite jusqu’à la prochaine LTS. Selon le cycle habituel de Symfony (une version en mai, une en novembre), ce sera 8.4, attendue fin 2027.
Reste à savoir si Drupal 12.0.0 sortira directement sur 8.2 ou si la bascule se fera juste après. Au moment où j’écris, la branche 12.0.x épingle encore 8.1. C’est l’issue queue de Drupal core qu’il faut suivre.
drupal/core ou drupal/core-recommended : la différence compte ici
La colonne de droite du tableau est importante. Regardez ce que votre projet requiert :
composer show drupal/core-recommended 2>/dev/null && echo "core-recommended" || echo "drupal/core seul"
composer why symfony/http-kernel
- Avec
drupal/core-recommended(le cas dudrupal/recommended-project), Symfony est épinglé sur une version de correctifs (~v8.1.6). Vous passerez à 8.2 quand Drupal core l’aura décidé et testé. C’est le comportement à vouloir en production. - Avec
drupal/coreseul, la contrainte est^8.1. Uncomposer updatele lendemain de la sortie de Symfony 8.2 vous installera 8.2 avant que Drupal core ne l’ait validé. Sur Drupal 11, la question ne se pose pas :^7.4ne peut pas aller au-delà de 7.4, la dernière version de la branche 7. Sur Drupal 12, c’est un vrai saut de version mineure.
Si vous êtes en drupal/core seul sur un projet Drupal 12, gardez-le en tête lors des mises à jour de décembre et janvier.
Ce que Drupal utilise vraiment de Symfony
Voici les composants requis par core/composer.json sur la branche 12.0.x :
console, dependency-injection, event-dispatcher, filesystem, finder, http-foundation, http-kernel, mailer, mime, process, psr-http-message-bridge, routing, runtime, serializer, validator, yaml (plus un polyfill).
Pas de FrameworkBundle, pas de Messenger, pas de Form, pas de Security, pas de Translation, pas d’ExpressionLanguage. Et même pour les composants utilisés, Drupal remplace souvent la pièce centrale par la sienne :
- le conteneur est compilé avec le
ContainerBuilderde Symfony, puis exporté par le dumper de Drupal (OptimizedPhpArrayDumper), pas par celui de Symfony ; - les normalizers de Drupal (
NormalizerBase, JSON:API) sont propres à Drupal et n’étendent pasAbstractObjectNormalizer; - le routing passe par le
UrlGeneratoret le routeur de Drupal.
C’est ce qui permet de trier rapidement les nouveautés de 8.2.
Les changements qui touchent du code Drupal
1. Console : codes de sortie après un signal
Avec Symfony Console 8.2, une commande interrompue par un signal ne sort plus avec le code 0, mais avec 128 + le numéro du signal : 130 pour SIGINT (Ctrl+C), 143 pour SIGTERM.
Drush s’appuie sur Symfony Console. Concrètement, sur un projet Drupal 12 qui passera à Console 8.2 :
- un
drush queue:runou tout autre worker lancé par systemd, supervisord ou Kubernetes et arrêté proprement parSIGTERMsortira en143; - systemd considérera alors le service comme failed après un
systemctl stop, sauf si la commande gèreSIGTERMelle-même ; - vos alertes ou vos scripts de déploiement qui testent le code de sortie peuvent se déclencher à tort.
La correction côté systemd est simple :
[Service]
ExecStart=/var/www/vendor/bin/drush queue:run my_queue --time-limit=3600
SuccessExitStatus=143
Autre changement de Console 8.2, plus rare : si deux commandes app:import et app:import:users existent, app:import users lance maintenant app:import:users au lieu de passer users en argument de app:import. Si vous avez des commandes Drush custom imbriquées de cette façon, testez-les.
2. Sessions : modifier un objet lu en session sans le réenregistrer
Symfony 8.2 déprécie un usage très courant :
// Avant : on modifie l'objet lu en session, sans rappeler set().
$session = $request->getSession();
$session->get('my_module.cart')->addItem($item);
En Symfony 9.0, les objets lus depuis la session seront des copies : seul ce qui est passé à set() sera sauvegardé. Le code ci-dessus perdra silencieusement les modifications.
La forme à adopter dès maintenant :
$session = $request->getSession();
$cart = $session->get('my_module.cart');
$cart->addItem($item);
$session->set('my_module.cart', $cart);
Point important pour Drupal : le service session.attribute_bag de Drupal est le AttributeBag de Symfony, instancié sans l’argument $debug. Cette dépréciation ne s’affichera donc pas dans vos logs Drupal. Il faut aller chercher ces usages vous-même, dans vos modules custom et contrib :
grep -rnE "getSession\(\)->get\([^)]*\)->" web/modules/custom
Ce n’est pas urgent pour Drupal 12, mais c’est exactement le genre de code qui cassera sans bruit le jour où Drupal passera à Symfony 9.
3. Serializer : uniquement si vous dénormalisez vers vos propres objets
Plusieurs changements du Serializer 8.2 concernent le ObjectNormalizer et la dénormalisation vers des classes PHP typées :
- dénormaliser un objet JSON à clés non séquentielles dans une propriété typée
list<...>est déprécié (exception en 9.0) ; - les collections de types union (
list<CardPayment|BankTransfer>) sont maintenant réellement dénormalisées, et un élément qui ne correspond à aucun type lève une exception au lieu d’être renvoyé tel quel ; #[SerializedName]s’applique désormais aux propriétés de type$isActiveavec un accesseurisActive().
Les normalizers d’entités de Drupal (REST, JSON:API) ne sont pas concernés. En revanche, si vous avez un module d’intégration qui fait $serializer->deserialize($json, PartnerDto::class, 'json') pour consommer une API externe, relisez vos DTO et lancez vos tests. Les gains de performance annoncés sur le Serializer (de 14 à 24 % sur la normalisation de listes) concernent aussi ce chemin ObjectNormalizer, pas les normalizers d’entités de Drupal : ne vous attendez pas à un JSON:API plus rapide.
4. Petites dépréciations à noter
- Filesystem : passer une chaîne vide comme chemin de base à
Path::isBasePath()est déprécié, il faut passer"/". - DependencyInjection :
AsDecorator::$priorityetAsEventListener::$prioritydeviennent?int(défautnull). Ça ne concerne que le code qui lit ces attributs par réflexion. - DependencyInjection : l’alias d’autowiring
Symfony\Component\EventDispatcher\EventDispatcherInterfaceest déprécié au profit deSymfony\Contracts\EventDispatcher\EventDispatcherInterface. Drupal déclare ses propres alias danscore.services.yml, donc pas de dépréciation chez vous. Mais pour un service qui ne fait que dispatcher, typer avec l’interface deContractsreste le bon choix.
Ce que vous pouvez ignorer
Ces nouveautés font les gros titres du blog Symfony, mais ne touchent pas un site Drupal :
- Le découpage de FrameworkBundle en bundles fournis par chaque composant : Drupal n’utilise pas FrameworkBundle.
- Le
CompiledEventDispatcher: c’est le serviceevent_dispatcherdu framework qui change. Celui de Drupal resteSymfony\Component\EventDispatcher\EventDispatchersur la branche12.0.x, alimenté par leRegisterListenersPassclassique. Vos subscribers ne changent pas (voir Event API). - Les gains de performance du conteneur (dump du conteneur de debug,
XmlDumper) : Drupal utilise son propre dumper. - Les changements de Routing comme
router.strict_requirements: c’est une option du framework. - Messenger (Inbox, transports signés, MongoDB, échange de messages entre applications) : Drupal core n’utilise pas Messenger. Seule exception, si vous utilisez le module contrib Symfony Messenger, qui l’intègre dans Drupal.
- Form, Security, AssetMapper, Translation, ExpressionLanguage : Drupal a ses propres systèmes.
À surveiller : le composant JsonSchema
Une nouveauté mérite d’être suivie même si elle ne vous concerne pas encore : symfony/json-schema. Il génère des schémas JSON Schema ou OpenAPI 3.1 à partir de types PHP, et surtout, avec generateForParameters(), le schéma d’entrée d’un outil pour agent IA à partir des paramètres d’une méthode PHP.
C’est précisément ce que doivent produire les modules qui exposent des actions Drupal à des LLM ou à des serveurs MCP. D’après l’annonce, le composant requiert PHP 8.2 et fonctionne avec les composants Symfony 7.4 : il pourrait donc être testé dès Drupal 11, à condition de vérifier les dépendances qu’il ajoute (TypeInfo, PropertyInfo). Rien à faire aujourd’hui, mais c’est le genre de brique que l’écosystème IA de Drupal pourrait adopter.
Les dépréciations de 8.2 préparent Drupal 13
Une règle simple à retenir : ce qui est déprécié dans Symfony 8.x est supprimé dans Symfony 9.0, et c’est la prochaine version majeure de Drupal après la 12 qui passera à Symfony 9.
Certaines de ces dépréciations sont statiques (une méthode ou une classe marquée @deprecated) : PHPStan avec phpstan-deprecation-rules, ou Upgrade Status, les détecteront le moment venu. D’autres sont des changements de comportement à l’exécution, comme la session ou la dénormalisation des listes : aucun outil d’analyse statique ne les verra. Seuls vos tests, et une relecture ciblée, les trouveront.
Que faire maintenant
Sur un site Drupal 11 :
- rien à faire pour Symfony 8.2 ;
- planifiez le passage en 11.4 minimum, idéalement 11.5 : c’est le prérequis pour monter en Drupal 12 (voir Drupal 12 alpha1).
Sur un projet Drupal 12 (ou qui le prépare) :
- vérifiez si vous dépendez de
drupal/core-recommendedou dedrupal/coreseul ; - auditez les workers Drush lancés par systemd, supervisord ou Kubernetes, et ajoutez
SuccessExitStatus=143(ou l’équivalent) là où c’est nécessaire ; - cherchez les objets modifiés en session sans
set(); - si vous dénormalisez vers des DTO, lancez vos tests d’intégration ;
- pour tester en avance,
symfony/*8.2.0-BETA1 est disponible : sur une branche de test uniquement, avecdrupal/coreà la place dedrupal/core-recommended,composer config minimum-stability betapuiscomposer update "symfony/*" -W.
Pour suivre la suite :
- la page Symfony 8.2 pour la date exacte de sortie ;
- le calendrier des versions de Drupal pour Drupal 12.0.0 et 11.5.0 ;
- l’issue queue de Drupal core pour la mise à jour vers Symfony 8.2.
Symfony 8.2 n’est pas un événement pour un site Drupal 11, et c’est une mise à jour de routine pour Drupal 12. Mais deux points méritent dix minutes dès maintenant : les codes de sortie de vos workers et les objets en session. Ce sont les seuls qui peuvent casser sans prévenir.
