L'architecture hexagonale ... concrètement

AFUP Day 11/06/2021 - Toulouse

Architecture hexagonale

1. Présentation du concept
2. Mise en place
3. Exemple d'implémentation
4. Aller plus loin

Problème

- “Ah, si on pouvait utiliser XXX ! ça a l’air trop bien !”

- “Oui, mais vu tout ce qu’il faudrait réécrire ...”

XXX = nouvelle lib / service / framework

Solution universelle

Version architecture hexagonale

Architecture hexagonale

Avantages

• Choix infrastructure plus tard
• Démo plus rapidement
• Montées de versions framework et lib plus faciles
• Bascule facile vers nouvelles lib / services
• Tests plus simples à écrire

Attention

• un peu plus de code à écrire
• outils de génération de code ne fonctionnent pas tous

⇒ à réserver aux applications complexes… ou qui vont le devenir

Exemple

Lien vers repo à la fin

Avec Symfony… car + utilisé et s’y prête bien

C'est une des implémentations possibles

Arborescence cible

Mise en place : étape 1

Modification autoload dans composer.json

Etape 2 : déplacement du Kernel

src/Kernel.php ⇒ src/Infrastructure/Symfony/Kernel.php

1. Corriger chemin vers config
2. Corriger instanciations dans :
   • bin/console
   • public/index.php
   • .env.test

Etape 3 : configuration services

services:

  Domain\:
    resource: '../src/Domain'
    exclude:
      - '../src/Domain/Entity/'

  Infrastructure\:
    resource: '../src/Infrastructure'
    exclude:
      - '../src/Infrastructure/Symfony/Kernel.php'

  Infrastructure\Symfony\Controller\:
    resource: '../src/Infrastructure/Symfony/Controller/'
    tags: ['controller.service_arguments']
				

Exemple Domain

Exemple Interface du Domain

Exemple Infrastructure Tests

Exemple Infrastructure

Infrastructure controller

Infrastructure CLI

Outil

Deptrac : github.com/qossmic/deptrac

Règles :

1. Domain n’utilise pas Infrastructure
2. Domain n’utilise aucun namespace externe
   (ex: Symfony, Doctrine, etc.)

Plusieurs contextes

Communication entre contextes

• par API
• par event (message bus)

Couches supplémentaires

Dans un legacy ?

1. Créer dossiers Domain et Infrastructure
2. Nouvelles fonctionnalités dans hexagonal
3. Migration progressive pour l'existant

Merci !

github.com/blanc-frederic/demo-hexa

Des questions ?