OpenSolid Core

Building blocks for modular architecture with Symfony.

Provides DDD-oriented abstractions ─ commands, queries, domain events, error handling, collections, and a convention-based module system ─ so you can focus on your domain logic instead of wiring infrastructure.

Installation

composer require open-solid/core

The bundle is auto-registered via Symfony Flex.

Modular Application Structure

Each bounded context lives in its own module with the same layered structure:

src/
├── Product/ # Module root
│ ├── Application/
│ │ └── Product/ # Aggregate
│ │ ├── Create/ # Use case (verb)
│ │ │ ├── CreateProduct.php # Command
│ │ │ └── CreateProductHandler.php # Handler
│ │ └── Find/
│ │ ├── FindProduct.php # Query
│ │ └── FindProductHandler.php # Handler
│ ├── Domain/
│ │ ├── Error/ # Domain-specific errors
│ │ ├── Event/ # Domain events
│ │ └── Model/ # Aggregate, entities and value objects
│ │ └── Product.php
│ └── Infrastructure/
│ ├── Resources/
│ │ └── config/
│ │ ├── doctrine/
│ │ │ └── mapping/ # Doctrine ORM mappings
│ │ ├── packages/ # Package-specific config overrides
│ │ └── services.yaml # Service definitions
│ └── ProductExtension.php # Module extension
│
├── Order/ # Another module
│ ├── Application/
│ ├── Domain/
│ └── Infrastructure/
│ └── OrderExtension.php
│
└── Kernel.php

Each ModuleExtension automatically registers services, and Doctrine mappings for its module ─ zero manual wiring.

Documentation

• Configuration ─ Bus strategies, Doctrine ORM mapping, and API Platform resource settings.
• Commands & Queries (CQS) ─ Type-safe command-query separation with auto-discovered handlers.
• Domain Events ─ Raise and react to events with automatic publishing after command execution.
• Error Handling ─ Structured domain errors with factory methods and batch error accumulation.
• Collections ─ Domain repository abstractions built on top of Doctrine Collections.
• Modular Architecture ─ Convention-based module system with automatic service registration.