Et si le Serializer arrêtait de deviner le type de vos propriétés ?
Quiconque a déjà dénormalisé un tableau JSON vers une collection d'objets connaît le problème : le composant sait remplir une propriété simple, mais dès que le type devient riche (une liste d'entités, un type paramétré), il faut multiplier les annotations et croiser les doigts. Symfony 8.2 améliore ce point en rapprochant le Serializer de ce que vous écrivez déjà dans votre code PHP.
Cet article fait le point sur ce que cette évolution change, à partir de l'annonce publiée sur le blog Symfony : New in Symfony 8.2: Generics and Stricter Types in the Serializer.
Le rôle de TypeInfo dans la dénormalisation
Le Serializer s'appuie sur le composant TypeInfo pour savoir quel type attendre pour chaque propriété lorsqu'il reconstruit un objet à partir de données brutes (JSON, XML, tableaux). Plus TypeInfo comprend finement vos déclarations, plus la dénormalisation est fidèle.
Avec Symfony 8.2, les deux composants gèrent davantage de types que vous écrivez déjà dans vos classes, notamment les génériques et des types plus stricts. Concrètement, l'information de type qui restait jusque-là approximative devient exploitable directement par le Serializer.
À retenir :
- TypeInfo est la source de vérité sur les types des propriétés
- Le Serializer l'interroge au moment de dénormaliser
- Une meilleure compréhension des types se traduit par des objets mieux construits
Ce que les génériques changent en pratique
En PHP, les génériques n'existent pas au niveau du langage : ils s'expriment dans la documentation de type (PHPDoc), par exemple pour décrire une collection d'un type précis. Les outils d'analyse statique comme PHPStan les lisent déjà. Le Serializer, lui, avait tendance à s'arrêter à la surface.
La nouveauté consiste à exploiter ces informations déjà présentes dans votre code. Vous n'avez pas à introduire une nouvelle syntaxe : le gain vient de la cohérence entre ce que l'analyse statique comprend et ce que le Serializer applique à l'exécution.
Un exemple de ce type de déclaration :
class Panier
{
/** @var list<Article> */
public array $articles = [];
}
Sur ce genre de structure, l'enjeu est que chaque élément de la liste soit reconstruit en objet du bon type, plutôt qu'en simple tableau associatif.
Des types plus stricts, moins d'erreurs à l'exécution
Un typage plus précis à la dénormalisation limite les cas où une donnée mal formée traverse silencieusement votre application pour exploser plus loin, loin de sa cause. Les erreurs apparaissent au moment de la conversion, là où elles sont les plus faciles à diagnostiquer.
L'angle à retenir est donc celui de la fiabilité : des objets complexes mieux reconstruits, et moins de surprises dans les couches métier qui les consomment.
Comment tester dès maintenant
Symfony 8.2 est en cours de développement, il est donc prudent de procéder sur une branche dédiée :
- Repérez les classes dénormalisées qui contiennent des collections ou des types paramétrés
- Vérifiez que leurs PHPDoc sont précises et cohérentes avec votre analyse statique
- Rejouez vos tests de sérialisation existants et comparez les résultats avant et après la montée de version
- Ajoutez des cas limites (données incomplètes, types inattendus) pour observer le comportement plus strict
Si vous n'avez pas de tests couvrant vos dénormalisations, c'est l'occasion d'en écrire : ce sont eux qui vous diront si le nouveau comportement vous bénéficie ou casse une hypothèse implicite.
Conclusion
Symfony 8.2 poursuit un mouvement de fond : faire en sorte que les types que vous écrivez servent réellement, à l'analyse statique comme à l'exécution. Pour les équipes qui manipulent beaucoup d'objets complexes via le Serializer, tester TypeInfo et ses nouvelles capacités dès maintenant permettra d'anticiper la migration et de profiter d'un typage plus fiable. Pour le détail complet des changements, reportez-vous à l'annonce originale sur le blog Symfony.
