🎻 Symfony 8.2 : un bundle par composant, une config enfin typée et un AssetMapper plus méfiant

📚 Introduction
Symfony 8.2 est la version mineure sortie en novembre 2026. D’après la page de release, elle demande PHP 8.4 au minimum et sera maintenue jusqu’en juillet 2027. Tout ce qui suit vient de la série « New in Symfony 8.2 » du blog officiel et du code de la branche 8.2.
La série « Living on the edge » a publié 46 billets sur cette version. C’est beaucoup, alors j’ai découpé. Ce premier article donne la vue d’ensemble et détaille ce qui touche tout le monde : la refonte de FrameworkBundle, le JSON Schema de configuration, la Tui, AssetMapper, Translation et WebLink. Quatre articles suivront, sur Messenger, sur les formulaires et la validation, sur la sécurité et les expressions, et sur Serializer, HttpClient et le HTTP Recorder.
Si tu arrives de Symfony 8.1, l’état d’esprit reste le même : pas de rupture, des dépréciations avec leur remplaçant. Le socle PHP 8.4 date de Symfony 8.0.
🧩 Qu’est-ce que « un bundle par composant » change pour mon app ?
Rien d’obligatoire. Chaque composant embarque maintenant son propre bundle (le billet officiel en annonce 29, comme CacheBundle, HttpClientBundle, MailerBundle ou MessengerBundle), ils s’enregistrent seuls dès que le composant est installé, et toutes les clés framework.* restent valides, sans dépréciation.
Le point de départ est simple. FrameworkBundle servait de colle pour presque tout : ajouter une option au Mailer demandait de toucher le composant et FrameworkBundle, certaines sections en activaient d’autres en douce (activer les formulaires activait la validation), et chaque fichier de config/packages/ commençait par un framework: qui n’apportait rien.
Dans la branche 8.2, l’enregistrement passe par un attribut posé sur FrameworkBundle lui-même :
#[RequiredBundle(ServicesBundle::class)]
#[RequiredBundle(RouterBundle::class)]
#[RequiredBundle(CacheBundle::class)]
#[RequiredBundle(ConsoleBundle::class, ignoreOnInvalid: true)]
#[RequiredBundle(AssetBundle::class, ignoreOnInvalid: true)]L’extrait est tronqué : la branche en aligne aujourd’hui 33, ServicesBundle et les bundles des nouveaux composants KeyManagement et JsonSchema compris. Rien à ajouter dans config/bundles.php.
Ce qu’on gagne, c’est la possibilité de retirer le niveau framework: :
# config/packages/mailer.yaml
- framework:
- mailer:
- dsn: '%env(MAILER_DSN)%'
+ mailer:
+ dsn: '%env(MAILER_DSN)%'La plupart des clés gardent leur nom à la racine. Trois exceptions à retenir : framework.assets devient asset, framework.translator devient translation et framework.workflows devient workflow. Les clés lock et semaphore acceptent aussi directement un DSN :
# config/packages/lock.yaml
lock: '%env(LOCK_DSN)%'Quelques effets de bord à connaître : debug:config framework mailer ne marche plus (c’est debug:config mailer), activer les formulaires n’active plus la validation (c’est l’installation de symfony/validator qui le fait), et quelques classes quittent FrameworkBundle avec dépréciation : RedirectController part dans Routing, TemplateController dans TwigBundle, RouteLoaderInterface est remplacée par l’attribut #[AsRouteLoader]. Côté performance, le billet précise que la plupart de ces bundles ne servent qu’à la compilation du container et ne sont plus instanciés à chaque requête en production.
Pour les auteurs de bundles, le composant Config gagne aliasOf(), qui fait suivre un nœud vers la configuration d’une autre extension (c’est ainsi que framework.workflows continue de marcher), et appendFromCallback(), qui factorise un groupe d’options sans casser la chaîne fluide.
🛠️ JSON Schema pour config/packages
Symfony 7.4 avait fourni des schémas pour services.yaml et routes.yaml, mais pas pour config/packages/, là où on écrit l’essentiel de son YAML. Le souci : le schéma dépend des bundles installés. Symfony 8.2 le génère donc dynamiquement. Quand le container est compilé en mode debug et que symfony/yaml est présent, un fichier config/schema.json est écrit, when@<env> compris, et régénéré à chaque compilation. C’est le pendant YAML du config/reference.php arrivé en 7.4.
L’IDE ne le devine pas, il faut le lui indiquer. Avec un éditeur basé sur yaml-language-server :
# config/packages/framework.yaml
# yaml-language-server: $schema=../schema.json
framework:
secret: '%env(APP_SECRET)%'
# ...Ou une seule fois pour tout le dossier dans .vscode/settings.json :
{
"yaml.schemas": {
"config/schema.json": "config/packages/**/*.yaml"
}
}Le morceau que je branche en CI dès la migration, c’est lint:yaml --check-schema. Il demande opis/json-schema :
composer require opis/json-schema
# validate each file against its own schema
php bin/console lint:yaml config/ --check-schemaSans argument, l’option lit le commentaire $schema= ou, pour les emplacements standard, choisit seule le bon schéma. Le billet prévient d’une limite : les valeurs acceptées grâce à une normalisation à l’exécution (un beforeNormalization() qui transforme une chaîne en liste, par exemple) peuvent être signalées à tort.
🖥️ La Tui grandit
Le composant Tui, introduit en 8.1 et toujours marqué expérimental, reçoit une grosse fournée. Le TabsWidget affiche un widget à la fois parmi plusieurs onglets, avec les en-têtes placés sur n’importe quel côté :
use Symfony\Component\Tui\Event\TabChangeEvent;
use Symfony\Component\Tui\Widget\TabItem;
use Symfony\Component\Tui\Widget\TabsWidget;
// each tab defines its ID, its label and the widget with its contents
$tabs = new TabsWidget([
new TabItem('routes', 'Routes', $routes),
new TabItem('messenger', 'Messenger', $messages),
new TabItem('cache', 'Cache', $cachePools),
new TabItem('logs', 'Logs', $logs),
]);
$tabs->onTabChange(function (TabChangeEvent $event) use ($status): void {
$status->setText(sprintf('Viewing %s', $event->getId()));
});
$tui->add($tabs);
$tui->setFocus($tabs);
Animation publiée par Symfony dans le billet « Tui Improvements ».
Arrivent aussi un CollapsibleWidget (l’équivalent terminal de <details>), une option multiselect sur SelectListWidget et un KeyBindingWidget qui affiche les raccourcis du widget focalisé, comme la barre d’aide en bas des outils en ligne de commande :

Le reste vise les auteurs de widgets : attachChild() et detachChild() remplacent des méthodes internes, postRender() permet de retoucher le rendu final, les listeners survivent au retrait d’un widget (et off() sert à les enlever). Le rendu réutilise les lignes inchangées entre deux frames. Les modificateurs super, hyper et meta du protocole clavier Kitty sont reconnus, et un raccourci mal orthographié lève désormais une InvalidArgumentException au lieu de ne jamais se déclencher. Enfin, setProgramStatus() implémente le Program Status Protocol (OSC 7501) pour signaler au terminal qu’un programme travaille, attend une validation ou a fini. Avec les agents de code qui tournent en terminal, ça tombe bien.
🔒 AssetMapper se méfie de npm
C’est la partie que j’attendais le plus. Deux options visent directement la chaîne d’approvisionnement. D’abord, le Subresource Integrity :
# config/packages/asset_mapper.yaml
framework:
asset_mapper:
importmap_integrity_algorithms: ['sha384']importmap() ajoute alors la clé integrity à l’import map et l’attribut integrity aux balises modulepreload et stylesheet (sha256, sha384 et sha512 sont acceptés). Ensuite, un âge minimum avant d’adopter une nouvelle version, comme le proposent déjà npm, pnpm et yarn :
# config/packages/asset_mapper.yaml
framework:
asset_mapper:
# in seconds (7 days); the default value (0) disables this check
minimum_release_age: 604800importmap:update ignore alors les versions trop récentes (et les préversions), et importmap:outdated les affiche dans une nouvelle colonne Withheld. importmap:require n’est pas bridé, pour garder une porte de sortie en cas de correctif urgent. Contrepartie notée dans le billet : il faut télécharger les métadonnées npm complètes de chaque paquet, bien plus lourdes.
Trois réglages plus discrets complètent le tableau. importmap_entries: reachable ne rend que les entrées atteignables depuis les points d’entrée de la page, pour que la page de login ne dévoile plus les dépendances du back-office (désactivé par défaut, car un import(someVariable) ne peut pas être suivi). metadata_dir sort manifest.json et importmap.json du dossier public. Et en mode debug, les assets compilés par asset-map:compile sont ignorés : fini le public/assets/ oublié qui masque tes modifications. Il y a aussi importmap:require --no-esm pour récupérer un fichier tel que publié quand le build ESM de jsDelivr est cassé.
Si tu as quitté AssetMapper pour un bundler, le chemin inverse existe aussi : je l’ai décrit avec Symfony Reprise.
🌍 Translation : du HTML sans |raw
Le filtre trans_html règle un vieux problème : le lien au milieu d’une phrase traduite, rendu avec |raw et donc sans échappement des paramètres. Les traductions ne contiennent plus que des pseudo-balises sans attributs :
# translations/messages+intl-icu.en.yaml
auth_prompt: 'Hi {name}! Please <signin_link>sign in</signin_link> or <signup_link>create an account</signup_link>.'{{ 'auth_prompt'|trans_html(tags: {
signin_link: { tag: 'a', attr: { href: path('login') } },
signup_link: [{ tag: 'strong' }, { tag: 'a', attr: { href: path('register') } }],
}, arguments: { name: user.name }) }}Tout ce qui n’est pas déclaré est échappé, script et style sont refusés, et des balises déséquilibrées font échapper le message entier. Une classe HtmlTranslator offre la même chose côté PHP, pour les e-mails par exemple.
Le billet « Translation Improvements » ajoute la commande translation:update-xliff-sources, qui remplit les <source> des XLIFF avec la langue par défaut au lieu de la clé, le modificateur {% trans_default_domain 'catalog' for _self %} qui couvre aussi les embed et les macros, des group_by traduisibles dans ChoiceType, et un translation:extract bien plus malin : il suit les ternaires, les match, les variables et même les méthodes d’enum, et trouve les libellés passés à form_row() ou form_label().
🔗 WebLink : Link-Template et link sets
WebLink couvre enfin les deux RFC construites sur Web Linking. Les liens templatés (/users/{id}), que Symfony supprimait en silence faute d’en-tête adapté, partent maintenant dans Link-Template (RFC 9652) :
$this->addLink($request, new Link('preload', '/app.css')->withAttribute('as', 'style'));
$this->addLink($request, new Link('item', '/users/{id}'));
// the response includes these headers:
// Link: </app.css>; rel="preload"; as="style"
// Link-Template: "/users/{id}"; rel="item"Pour les link sets (RFC 9264), JsonLinksetSerializer et JsonLinksetParser produisent et lisent le format application/linkset+json. Le billet s’en sert pour exposer un catalogue d’API sur /.well-known/api-catalog (RFC 9727). LinkTemplateHeaderParser lit l’en-tête côté client. Niche, mais pour qui publie une API hypermédia, c’est du code maison en moins.
🧭 Le reste de la release en bref
Quatre thèmes auront leur article dans cette série, donc ici juste les titres :
- Messenger : flows déclarés au dispatch, inbox et outbox transactionnelles, claim check, messages entre applications, transports signés avec rotation des secrets, workers
--concurrency, transport MongoDB. - Formulaires et validation : formulaires définis par attributs, types devinés depuis les types PHP,
PolymorphicCollectionType,BoundsType, contraintesEntityExists,CronetAudio,Callbackavecmessage. - Sécurité et expressions : login OpenID Connect natif, sudo mode, logout en POST, wildcards dans la hiérarchie de rôles, firewall choisi par la route, URL signées à usage unique, expressions compilées et validées.
- Serializer, HttpClient et HTTP Recorder : génériques au dénormaliseur, groupes de sérialisation par nom, enregistrement et rejeu des appels HTTP dans les tests, trailers HTTP.
Et ce qui ne rentre dans aucune case : deux nouveaux composants expérimentaux, KeyManagement (chiffrement d’enveloppe adossé à un KMS, avec un attribut #[Encrypted] pour les colonnes Doctrine) et JsonSchema (schémas générés depuis les types PHP, utiles pour OpenAPI ou les outils d’agents IA). La Console accepte des sous-commandes séparées par des espaces, les workflows se déclarent par attributs, un attribut #[Lock] empêche un contrôleur de tourner deux fois en parallèle, et un contrôleur peut récupérer l’échec d’un attribut comme #[RateLimit] au lieu de laisser partir l’exception. Le dispatcher d’événements est compilé, les listeners et services se rangent les uns par rapport aux autres plutôt qu’avec des priorités chiffrées, et Nicolas Grekas a passé la Symfony Demo au profileur pour un billet entier de gains de performance. Côté HTTP et e-mail : en-têtes CDN-Cache-Control ciblés et Cache-Status, PGP/MIME dans Mailer, templates hébergés chez le fournisseur, et des adaptateurs de cache MongoDB.
⚠️ Quelques précautions
- C’est une version neuve. Les extraits ci-dessus viennent des billets officiels et de la branche
8.2. Lis les notes de mise à jour et la liste des dépréciations avant de migrer, et garde en tête que KeyManagement, JsonSchema et la Tui restent marqués expérimentaux. debug:config framework <section>ne fonctionne plus pour les sections déplacées : pense à tes scripts et à ta doc interne.- Formulaires sans validation : si ton app comptait sur le fait qu’activer les formulaires active la validation, vérifie que
symfony/validatorest bien installé. lint:yaml --check-schemapeut lever des faux positifs sur les options normalisées à l’exécution. Ne le rends pas bloquant en CI sans un premier passage.minimum_release_agealourdit les vérifications de mises à jour, puisqu’il télécharge les métadonnées npm complètes.
🎉 Conclusion
Le gros chantier de 8.2 ne se voit pas dans le code applicatif : FrameworkBundle cède la configuration de chaque composant au composant lui-même. On n’a rien à faire, on peut juste écrire mailer: au lieu de framework: mailer: et profiter d’un schema.json qui documente la config dans l’éditeur. Le reste suit la même pente, avec des comportements implicites qui disparaissent (formulaires et validation) et des garde-fous qui arrivent (SRI, âge minimum des paquets, trans_html).
Mon conseil : installe Symfony 8.2 sur une branche, lance lint:yaml config/ --check-schema et regarde ce qui remonte. La suite de la série détaille Messenger, les formulaires, la sécurité et le Serializer.
🔗 Liens utiles
- Symfony 8.2 : page de release
- Série « Living on the edge »
- New in Symfony 8.2 : One Bundle per Component
- New in Symfony 8.2 : JSON Schema for Configuration
- New in Symfony 8.2 : Tui Improvements
- New in Symfony 8.2 : AssetMapper Improvements
- New in Symfony 8.2 : Translation Improvements et Safer HTML in Translations
- New in Symfony 8.2 : Link Sets and Link Templates
- Code source, branche 8.2
/faq
Questions fréquentes
Quand est sorti Symfony 8.2 et quelle version de PHP faut-il ?
+
Symfony 8.2 est sorti en novembre 2026. Il demande PHP 8.4 au minimum et sera maintenu jusqu'en juillet 2027.
Faut-il modifier sa configuration pour passer à un bundle par composant ?
+
Non. Les nouveaux bundles s'enregistrent tout seuls quand leur composant est installé, et toutes les clés framework.* (framework.mailer, framework.messenger…) continuent de fonctionner sans dépréciation. Retirer le niveau framework: est optionnel.
Comment activer l'autocomplétion YAML de config/packages dans Symfony 8.2 ?
+
En mode debug, avec symfony/yaml installé, Symfony écrit un fichier config/schema.json à chaque compilation du container. Il suffit de le déclarer à son éditeur, par exemple avec le commentaire # yaml-language-server: $schema=../schema.json en tête de fichier.
À quoi sert minimum_release_age dans AssetMapper ?
+
C'est une protection contre les attaques de la chaîne d'approvisionnement : importmap:update ignore les versions de paquets publiées depuis moins que la durée indiquée (en secondes). importmap:require n'est pas concerné, pour permettre une mise à jour urgente.