Mathieu Desnouveaux

API Platform : repenser les filtres

Présentation par Vincent Amstoutz sur la refonte des filtres dans API Platform lors d'un meetup AFUP Lorraine

Sketchnote illustrant les filtres API Platform présentée lors d'un meetup AFUP Lorraine. Le schéma explique qu'un filtre permet de limiter des ressources selon des critères par des attributs sur nos entités (ORM/ODM & Elastic Search). Il y a une refonte suite à l'arrivée de la compatibilité avec Laravel. Le découpage d'un filtre fourre-tout (SearchFilter avec IRI Filter, Exact Filter, Partial Filter, OR Filter, etc.) devient plus simple et respectueux. Les filtres plus simples montrent l'usage d'objets > tableaux pour la maintenance du framework et la possibilité de créer ses filtres personnalisés avec un Query Builder. Le Parameter Provider permet de transformer un paramètre (URI + parent + chain + resource) et la documentation automatique. La génération par Maker ainsi que la migration sans BC break avec les commandes Maker & Rector pour migrer.

Cette sketchnote a été réalisée lors d'un meetup AFUP Lorraine le 24 novembre 2025. Elle illustre la présentation "API Platform : repenser les filtres" donnée par Vincent Amstoutz, qui détaille la refonte majeure du système de filtres suite à la compatibilité Laravel.

Contenu de la présentation

Vincent Amstoutz explique la refonte des filtres API Platform motivée par Laravel. Exit le SearchFilter monolithique, place à des filtres atomiques (IRI, Exact, Partial, OR) plus respectueux et maintenables. L'architecture privilégie objets sur tableaux pour faciliter l'évolution du framework. Les Query Builders permettent des filtres personnalisés. Le Parameter Provider transforme les paramètres (URI, parent, chain, resource) avec documentation automatique. Maker génère le code, Rector migre sans casser la compatibilité. Une modernisation élégante pour des API plus flexibles.

Thèmes:
🐘 PHP 🔗 API 🏗️ Architecture
Événement:
🍻 AFUP Lorraine
Source: Vincent Amstoutz