Sommaire · 6 parties

Sylius est une solution e-commerce open source construite sur Symfony, utilisée pour les catalogues volumineux, le B2B complexe et les marketplaces. Une équipe déjà formée à Symfony n’a pas à repartir de zéro, mais Sylius impose ses propres conventions — Resource System, grids, state machines — qui demandent un apprentissage ciblé avant de livrer un projet maintenable. Ce guide détaille ces fondamentaux techniques ; notre agence e-commerce accompagne les entreprises qui choisissent Sylius pour ce type de projet.

Qu’est-ce que le Resource System de Sylius ?

Le Resource System est l’abstraction centrale de Sylius : il gère de façon uniforme toutes les entités métier (produits, commandes, clients, ou une ressource personnalisée). En déclarant une ressource dans config/packages/sylius_resource.yaml, l’équipe obtient automatiquement contrôleurs, formulaires, repositories et routes RESTful, sans code supplémentaire.

Les ressources Sylius restent des entités Doctrine, enrichies d’interfaces comme ResourceInterface. Cette proximité avec les concepts Symfony classiques (Doctrine, composant Form) facilite la transition d’une équipe déjà formée : les listeners d’événements permettent d’ajouter des validations ou des traitements métier sans toucher au code core.

Comment fonctionnent les grids et les state machines ?

Les grids génèrent des interfaces d’administration complètes (tri, pagination, filtres, actions en masse) à partir d’une simple configuration YAML, sans écrire de HTML ni de JavaScript. Une vingtaine de types de colonnes couvrent la majorité des besoins ; des types personnalisés via ColumnTypeInterface s’ajoutent pour des besoins métier spécifiques.

Les state machines, basées sur le composant Symfony Workflow, contrôlent les transitions d’état des entités critiques : une commande ne peut passer à « expédiée » que si elle est « payée ». Chaque transition peut déclencher des actions automatiques (notification, mise à jour de stock) et être conditionnée par des règles métier (guards). Ce pattern rend explicites des règles qui, sans lui, resteraient implicites dans le code — et donc sources d’erreurs lors des évolutions.

Comment personnaliser Sylius sans compromettre les mises à jour ?

La règle de base : préférer toujours les événements et la décoration de services à la modification directe du code core. Le système d’événements de Sylius (hérité d’EventDispatcher) déclenche des événements à chaque étape clé — création de commande, ajout au panier, paiement — qu’un listener ou un subscriber peut intercepter sans toucher à Sylius lui-même.

Quand une modification plus profonde s’impose, la décoration de service (attribut decorates dans services.yaml) permet d’envelopper un service existant tout en conservant la possibilité d’appeler son comportement d’origine. L’héritage direct de classes ou la modification du core doivent rester un dernier recours : chaque override documenté et testé représente un coût de maintenance à chaque montée de version.

Pour isoler le code métier, un bundle Symfony custom par domaine fonctionnel (par exemple un bundle marketplace, un bundle fidélité) plutôt qu’une dispersion dans la structure par défaut simplifie les tests et la maintenance à plusieurs développeurs.

Comment une équipe Symfony monte-t-elle en compétences sur Sylius ?

Une équipe déjà à l’aise avec Symfony (Doctrine, conteneur de services, formulaires, sécurité) dispose de bases directement réutilisables. Les notions propres à Sylius — Resource System, grids, channels, state machines e-commerce, concepts de produits et de taxons — restent à acquérir spécifiquement ; la durée de cette montée en compétences dépend du projet et du niveau de l’équipe, et ne se résume pas à un pourcentage ou un délai universel.

Un parcours progressif fonctionne mieux qu’un apprentissage théorique isolé : documentation officielle, installation d’un projet pilote simple, puis des fonctionnalités croissantes (ressource custom avec grid, personnalisation du checkout, règle de promotion). L’accompagnement par un développeur Sylius expérimenté, via du pair programming et des revues de code régulières, accélère cette phase en évitant les pièges non documentés.

Il n’existe pas encore de certification Sylius officielle comparable à la certification Symfony, qui reste le point de référence le plus proche pour valider les fondamentaux. À défaut, un test pratique sur un cas représentatif du projet (ressource custom, grid, state machine) donne une mesure plus fiable qu’un entretien théorique.

Ce qu’il faut retenir

Sylius transforme une équipe Symfony en équipe e-commerce à condition de respecter ses conventions : Resource System pour les entités, grids pour l’administration, state machines pour les workflows, événements plutôt que modification du core. Un projet bien structuré dès le départ — bundles custom par domaine, décoration plutôt qu’héritage — reste maintenable sur plusieurs années de montées de version. Pour un projet qui démarre, ce choix d’architecture compte autant que la compétence technique de l’équipe.

Questions fréquentes

Quelle est la différence principale entre développer sur Symfony et sur Sylius ?

Symfony fournit les briques techniques (routage, services, formulaires, ORM) sans imposer de convention métier. Sylius ajoute une couche e-commerce complète par-dessus : le Resource System pour gérer les entités, les grids pour les interfaces d’administration, et les state machines pour les workflows de commande, paiement et expédition.

Faut-il modifier le code core de Sylius pour le personnaliser ?

Non, et c’est à éviter. Sylius prévoit des points d’extension explicites : événements, décoration de services, resource customization. Les modifier directement complique les montées de version ; les événements et la décoration permettent la même personnalisation sans ce risque.

Existe-t-il une certification Sylius officielle ?

Pas encore. La certification Symfony reste le point de référence le plus proche, puisqu’elle valide les fondamentaux (Doctrine, formulaires, sécurité) sur lesquels Sylius est construit. À défaut, un test pratique sur un cas représentatif du projet reste le moyen le plus fiable d’évaluer une équipe.

Sources