layout: default title: Accueil nav_order: 1 lang: fr lang_ref: / description: "Bundle Symfony Maker pour l'Architecture Hexagonale (Ports & Adapters) - 19 commandes maker pour domaine pur, CQRS et couverture complète" permalink: /fr/

Hexagonal Maker Bundle

Pourquoi l'Architecture Hexagonale ?

L'architecture hexagonale (alias Ports & Adapters) vous aide à construire des applications maintenables et testables en :

• 💎 Isolation du Domaine - Logique métier indépendante des frameworks
• 🎯 Contrôle des Dépendances - L'infrastructure dépend du domaine, pas l'inverse
• ⚡ Vitesse de Test - Tests unitaires 1000x plus rapides (pas de base de données)
• 🔄 Liberté Technologique - Changez de base de données, de framework sans toucher la logique métier
• 💰 Coût Prévisible - Les fonctionnalités coûtent un temps constant, pas de taxe de dette technique

Lire le guide complet →

⚡ Démarrage Rapide (2 minutes)

Étape 1 : Installation

composer require ahmed-bhs/hexagonal-maker-bundle --dev

Étape 2 : Générez votre premier module

# Créer un module d'enregistrement utilisateur
bin/console make:hexagonal:entity user/account User
bin/console make:hexagonal:repository user/account User
bin/console make:hexagonal:command user/account register --factory
bin/console make:hexagonal:controller user/account RegisterUser /users/register

Étape 3 : Configurez le mapping Doctrine

# config/packages/doctrine.yaml
doctrine:
    orm:
        mappings:
            UserAccount:
                type: yml
                dir: '%kernel.project_dir%/src/User/Account/Infrastructure/Persistence/Doctrine/Orm/Mapping'
                prefix: 'App\User\Account\Domain\Model'

Résultat : Module hexagonal complet avec domaine pur, commandes CQRS et contrôleurs web ! 🚀

Guide d'installation complet →

Fonctionnalités

19 Commandes Maker

Générez une architecture hexagonale complète avec une seule commande :

Voir les 19 commandes →

Documentation

Documentation Avancée (Nouveaux Guides) 🆕

Ces guides approfondis couvrent les aspects critiques de l'architecture hexagonale :

Exemple : Module Utilisateur Complet

Étape 1 : Domaine

Générer les entités de domaine pures

bin/console make:hexagonal:entity user/account User
bin/console make:hexagonal:value-object user/account Email
bin/console make:hexagonal:exception user/account InvalidEmailException

Généré :

• Domain/Model/User.php (PHP pur)
• Domain/ValueObject/Email.php
• Domain/Exception/InvalidEmailException.php

Étape 2 : Application

Générer les cas d'usage et commandes

bin/console make:hexagonal:repository user/account User
bin/console make:hexagonal:command user/account register --factory
bin/console make:hexagonal:query user/account find-by-id

Généré :

• Domain/Port/UserRepositoryInterface.php
• Application/Register/RegisterCommand.php
• Application/Register/RegisterCommandHandler.php
• Application/FindById/FindByIdQuery.php

Étape 3 : Infrastructure

Adaptateurs auto-générés

# Déjà générés avec la commande repository !

Généré :

• Infrastructure/Persistence/Doctrine/DoctrineUserRepository.php
• Infrastructure/Persistence/Doctrine/Orm/Mapping/User.orm.yml

Étape 4 : UI

Générer contrôleurs et formulaires

bin/console make:hexagonal:controller user/account RegisterUser /users/register
bin/console make:hexagonal:form user/account User

Généré :

• UI/Http/Web/Controller/RegisterUserController.php
• UI/Http/Web/Form/UserType.php

Couches d'Architecture

%%{init: {'theme':'base', 'themeVariables': { 'fontSize':'14px'}}}%%
graph TB
    subgraph UI["🎮 COUCHE UI"]
        HTTP["Contrôleurs HTTP"]
        CLI["Commandes CLI"]
    end

    subgraph APP["⚙️ COUCHE APPLICATION"]
        Commands["Commandes & Queries"]
    end

    subgraph DOMAIN["💎 COUCHE DOMAINE"]
        Entities["Entités & Value Objects"]
        Ports["Ports (Interfaces)"]
    end

    subgraph INFRA["🔌 COUCHE INFRASTRUCTURE"]
        Adapters["Adaptateurs (Implémentations)"]
    end

    UI ==>|utilise| APP
    APP ==>|dépend de| DOMAIN
    INFRA -.->|implémente| Ports

    style DOMAIN fill:#C8E6C9,stroke:#2E7D32,stroke-width:4px
    style APP fill:#B3E5FC,stroke:#0277BD,stroke-width:3px
    style INFRA fill:#F8BBD0,stroke:#C2185B,stroke-width:3px
    style UI fill:#E1BEE7,stroke:#6A1B9A,stroke-width:3px

Règle de Dépendance : Toutes les dépendances pointent vers l'intérieur. Le domaine n'a aucune dépendance.

Guide d'architecture →

CRUD en 1 Commande ⚡

Générez un module CRUD complet avec toutes les couches :

bin/console make:hexagonal:crud blog/post Post --with-tests --with-id-vo

Généré (30+ fichiers) :

• Entité + ValueObjects + Repository
• 5 Cas d'Usage (Create, Update, Delete, Get, List)
• 5 Contrôleurs + Formulaire
• Tous les tests (Cas d'Usage + Contrôleur)
• Mapping YAML Doctrine

Exemples CRUD →

Architecture Layers

%%{init: {'theme':'base', 'themeVariables': { 'fontSize':'14px'}}}%%
graph TB
    subgraph UI["🎮 COUCHE UI"]
        HTTP["Contrôleurs HTTP"]
        CLI["Commandes CLI"]
    end

    subgraph APP["⚙️ COUCHE APPLICATION"]
        Commands["Commandes & Queries"]
    end

    subgraph DOMAIN["💎 COUCHE DOMAINE"]
        Entities["Entités & Value Objects"]
        Ports["Ports (Interfaces)"]
    end

    subgraph INFRA["🔌 COUCHE INFRASTRUCTURE"]
        Adapters["Adaptateurs (Implémentations)"]
    end

    UI ==>|utilise| APP
    APP ==>|dépend de| DOMAIN
    INFRA -.->|implémente| Ports

    style DOMAIN fill:#C8E6C9,stroke:#2E7D32,stroke-width:4px
    style APP fill:#B3E5FC,stroke:#0277BD,stroke-width:3px
    style INFRA fill:#F8BBD0,stroke:#C2185B,stroke-width:3px
    style UI fill:#E1BEE7,stroke:#6A1B9A,stroke-width:3px

Règle de Dépendance : Toutes les dépendances pointent vers l'intérieur. Le domaine n'a aucune dépendance.

Prérequis

• PHP 8.1+
• Symfony 6.4+ ou 7.x
• Composer

Contribution

Nous accueillons les contributions ! Voir notre Guide de Contribution.

Licence

Licence MIT - voir LICENSE pour les détails.

Créé par Ahmed EBEN HASSINE