layout: default title: Home nav_order: 1 lang: en lang_ref: /fr/ description: "Symfony Maker Bundle for Hexagonal Architecture (Ports & Adapters) - 19 maker commands for pure domain, CQRS, and full layer coverage" permalink: /

Hexagonal Maker Bundle

Why Hexagonal Architecture?

Hexagonal architecture (aka Ports & Adapters) helps you build maintainable, testable applications by:

• 💎 Pure Domain Isolation - Business logic independent of frameworks
• 🎯 Dependency Control - Infrastructure depends on domain, not vice versa
• ⚡ Testing Speed - Unit tests run 1000x faster (no database needed)
• 🔄 Technology Freedom - Swap databases, frameworks without touching business logic
• 💰 Cost Predictability - Features cost consistent time, no technical debt tax

Read the complete guide →

⚡ Quick Start (2 minutes)

Step 1: Install

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

Step 2: Generate your first module

# Create a User Registration module
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

Step 3: Configure Doctrine mapping

# 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'

Result: Complete hexagonal module with pure domain, CQRS commands, and web controllers! 🚀

Full installation guide →

Features

19 Maker Commands

Generate complete hexagonal architecture with a single command:

See all 19 commands →

Example: Complete User Module

Step 1: Domain

Generate pure domain entities

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

Generated:

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

Step 2: Application

Generate use cases and commands

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

Generated:

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

Step 3: Infrastructure

Auto-generated adapters

# Already generated with repository command!

Generated:

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

Step 4: UI

Generate controllers and forms

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

Generated:

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

Architecture Layers

%%{init: {'theme':'base', 'themeVariables': { 'fontSize':'14px'}}}%%
graph TB
    subgraph UI["🎮 UI LAYER"]
        HTTP["HTTP Controllers"]
        CLI["CLI Commands"]
    end

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

    subgraph DOMAIN["💎 DOMAIN LAYER"]
        Entities["Entities & Value Objects"]
        Ports["Ports (Interfaces)"]
    end

    subgraph INFRA["🔌 INFRASTRUCTURE LAYER"]
        Adapters["Adapters (Implementations)"]
    end

    UI ==>|uses| APP
    APP ==>|depends on| DOMAIN
    INFRA -.->|implements| 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

Dependency Rule: All dependencies point inward. Domain has zero dependencies.

Architecture guide →

CRUD in 1 Command ⚡

Generate complete CRUD module with all layers:

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

Generated (30+ files):

• Entity + ValueObjects + Repository
• 5 Use Cases (Create, Update, Delete, Get, List)
• 5 Controllers + Form
• All tests (Use Case + Controller)
• Doctrine YAML mapping

CRUD examples →

Documentation

Core Guides

Advanced Topics 🆕

In-depth guides covering critical aspects of hexagonal architecture:

Requirements

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

Contributing

We welcome contributions! See our Contributing Guide.

License

MIT License - see LICENSE for details.

Created by Ahmed EBEN HASSINE