Symfony 8.2 arrive : ce que les développeurs Drupal doivent vraiment suivre

· 9 min de lecture

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 :

  1. 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.
  2. 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.

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 du drupal/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/core seul, la contrainte est ^8.1. Un composer update le 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.4 ne 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 ContainerBuilder de 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 pas AbstractObjectNormalizer ;
  • le routing passe par le UrlGenerator et 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:run ou tout autre worker lancé par systemd, supervisord ou Kubernetes et arrêté proprement par SIGTERM sortira en 143 ;
  • systemd considérera alors le service comme failed après un systemctl stop, sauf si la commande gère SIGTERM elle-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 $isActive avec un accesseur isActive().

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::$priority et AsEventListener::$priority deviennent ?int (défaut null). Ça ne concerne que le code qui lit ces attributs par réflexion.
  • DependencyInjection : l’alias d’autowiring Symfony\Component\EventDispatcher\EventDispatcherInterface est déprécié au profit de Symfony\Contracts\EventDispatcher\EventDispatcherInterface. Drupal déclare ses propres alias dans core.services.yml, donc pas de dépréciation chez vous. Mais pour un service qui ne fait que dispatcher, typer avec l’interface de Contracts reste 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 service event_dispatcher du framework qui change. Celui de Drupal reste Symfony\Component\EventDispatcher\EventDispatcher sur la branche 12.0.x, alimenté par le RegisterListenersPass classique. 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-recommended ou de drupal/core seul ;
  • 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, avec drupal/core à la place de drupal/core-recommended, composer config minimum-stability beta puis composer update "symfony/*" -W.

Pour suivre la suite :

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.