Sommaire · 6 parties
Un projet Sylius qui démarre vite peut devenir, deux ans plus tard, un projet où chaque nouvelle fonctionnalité prend trois fois plus de temps qu’au départ. La cause la plus fréquente : une architecture qui n’a pas anticipé la croissance du projet. L’architecture hexagonale et les bounded contexts du Domain-Driven Design répondent à ce risque, avec notre expérience du développement e-commerce sur Sylius et Symfony.
Qu’est-ce que l’architecture hexagonale appliquée à Sylius
L’architecture hexagonale, ou « ports et adaptateurs », conceptualisée par Alistair Cockburn, isole la logique métier du reste de l’application : les dépendances externes (base de données, API, framework) deviennent interchangeables. Dans un projet Sylius, cela signifie que les entités métier et les règles de gestion ne dépendent pas directement de Doctrine ni de Symfony.
Concrètement, plutôt que d’injecter un EntityManager Doctrine dans un service métier de gestion de commandes, on définit une interface (OrderRepositoryInterface) côté domaine. Son implémentation Doctrine, l’adaptateur, vit dans la couche infrastructure. La logique métier se teste alors sans base de données réelle, avec une implémentation en mémoire.
Comment les bounded contexts structurent un projet Sylius
Les bounded contexts délimitent les zones où un modèle métier donné reste valide et cohérent. Une marketplace Sylius distingue naturellement plusieurs contextes : catalogue, commande, livraison, et gestion des vendeurs pour une marketplace multi-vendeurs. Chaque contexte a son propre vocabulaire et ses propres règles ; la communication entre contextes passe par des interfaces ou des événements de domaine, jamais par un accès direct aux données internes d’un autre contexte.
Cette isolation évite qu’un modèle unique ne tente de couvrir tout le métier — la cause la plus fréquente d’entités surchargées et de dépendances enchevêtrées.
Quels bénéfices concrets sur la maintenance et les tests
La logique métier isolée dans le domaine, ne dépendant que d’interfaces, se teste sans framework ni base de données : des tests unitaires rapides qui couvrent l’ensemble des scénarios métier, y compris les cas limites difficiles à reproduire en test d’intégration. Les adaptateurs infrastructure, eux, se testent séparément sur leur seule interaction avec la technologie concernée.
L’ajout d’une fonctionnalité — un nouveau mode de paiement, un nouveau canal de vente — se fait alors principalement par extension : un nouvel adaptateur implémentant une interface existante, sans toucher à la logique de traitement des commandes déjà en place. Les tests existants continuent de passer, ce qui réduit fortement le risque de régression.
Comment intégrer cette discipline dans un travail agile
Architecture propre et méthode agile ne sont pas incompatibles : une architecture solide maintient une vélocité stable sprint après sprint, et l’architecture elle-même s’affine progressivement grâce aux retours de chaque itération. Intégrer des critères de qualité architecturale (séparation domaine/infrastructure, interfaces pour les dépendances externes, couverture de tests) dans la Definition of Done évite que la dette technique ne s’accumule silencieusement.
Des sprints de refactoring, dédiés à l’amélioration structurelle sans ajout de fonctionnalité, permettent de traiter ce qu’une vision ponctuelle, sprint par sprint, ne détecte pas toujours à temps.
Conclusion
L’architecture hexagonale et les bounded contexts demandent une rigueur plus grande dès les premiers sprints d’un projet Sylius. Ce choix se rentabilise à mesure que le projet vit : ajout de fonctionnalités sans régression, refactoring sécurisé par les tests, et une base de code qui reste compréhensible même quand l’équipe change. C’est un investissement qui se justifie pour un projet destiné à durer, pas pour un prototype à usage unique.
Questions fréquentes
L’architecture hexagonale ralentit-elle le développement au départ ?
Oui, elle demande une discipline initiale plus forte : définir des interfaces plutôt que d’appeler directement Doctrine, isoler la logique métier. Ce surcoût se compense par la suite, quand ajouter une fonctionnalité ou remplacer un composant ne demande plus de toucher à l’ensemble du système.
Faut-il appliquer l’architecture hexagonale dès le premier sprint ?
Les principes fondamentaux (séparation domaine/infrastructure, interfaces pour les dépendances externes) gagnent à être posés dès le départ. Les détails d’implémentation et le découpage précis des bounded contexts peuvent en revanche s’affiner au fil des itérations, à mesure que le métier se précise.
Quels outils vérifient le respect de l’architecture dans un projet Symfony ?
Des outils d’analyse statique comme PHPStan ou Psalm détectent les violations de dépendances. Des métriques de complexité cyclomatique et de couplage, suivies dans le temps, aident à repérer les zones qui s’écartent des principes architecturaux retenus.

