marcosroigdev/ddd-forge

Scaffolding tool for DDD & Hexagonal Architecture in PHP

v0.1.0 2025-09-27 09:08 UTC

Requires

• php: >=8.2
• nette/php-generator: ^4.2
• symfony/console: ^7.3
• symfony/filesystem: ^7.3

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.88
• phpstan/phpstan: ^2.1
• phpunit/phpunit: ^11

MIT

• Marcos Roig

• generator
• php
• cli
• ddd
• scaffolding
• architecture
• hexagonal

README

DDD-Forge ⚒️

DDD-Forge is a scaffolding tool for Domain-Driven Design and Hexagonal Architecture in PHP.
Generate clean code, bounded contexts, aggregates, value objects, and use cases with a single command.

🚧 Work in Progress – expect rapid changes.

✨ Features

• ✅ Initialize hexagonal project structure (init)
• ⏳ Generate bounded contexts (make:context)
• ⏳ Create aggregates, value objects and domain events
• ⏳ Generate use cases and ports
• ⏳ Symfony & Laravel recipes
• ⏳ Test scaffolding

🚀 Installation

Require the package in your project (soon available via Packagist):

composer require --dev marcosroigdev/ddd-forge

Requires PHP >= 8.2.

📦 Usage

Run the CLI:

# Using composer script
composer run forge -- init

# Or directly
bin/ddd-forge init

This will generate the base folder structure:

src/
├── Domain
│   └── (Aggregates, ValueObjects, DomainEvents)
├── Application
│   └── (UseCases, Ports)
├── Infrastructure
│   └── (Repositories, Adapters)
└── UI
└── (CLI, HTTP, etc.)

🤝 Contributing

Contributions, ideas and feedback are welcome! Please check CONTRIBUTING.md

📜 License

Released under the MIT License.