PHPackages                             luminor/luminor - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. luminor/luminor

ActiveLibrary[Framework](/categories/framework)

luminor/luminor
===============

A modern, open-source DDD framework for building REST APIs and domain-driven applications with event sourcing

v2.3.0(5mo ago)08MITPHPPHP ^8.2CI passing

Since Dec 13Pushed 5mo agoCompare

[ Source](https://github.com/oliwerhelsen/luminor)[ Packagist](https://packagist.org/packages/luminor/luminor)[ Docs](https://luminor-php.github.io/luminor)[ RSS](/packages/luminor-luminor/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (4)Dependencies (6)Versions (10)Used By (0)

Luminor PHP Framework
=====================

[](#luminor-php-framework)

[![License: MIT](https://camo.githubusercontent.com/08cef40a9105b6526ca22088bc514fbfdbc9aac1ddbf8d4e6c750e3a88a44dca/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d626c75652e737667)](https://opensource.org/licenses/MIT)[![PHP Version](https://camo.githubusercontent.com/d840cef9807c8f76051ad687841d67f4d830c84e0d83236968e53124ef6742d5/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253345253344382e322d3838393242462e737667)](https://php.net/)![Tests](https://camo.githubusercontent.com/3ab4882a1b7d64e5eb5168ad0b0b9cdfd53f59f114ee5f727958504214a5789c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f74657374732d70617373696e672d627269676874677265656e2e737667)

A modern, open-source Domain-Driven Design (DDD) framework built on [Symfony HttpFoundation](https://symfony.com/doc/current/components/http_foundation.html), designed for building REST APIs and domain-driven applications. Heavily inspired by [Laravel](https://laravel.com), bringing its elegant developer experience to the world of Domain-Driven Design.

Features
--------

[](#features)

### Core DDD Features

[](#core-ddd-features)

- **Domain-Driven Design** - Built-in abstractions for Entities, Aggregate Roots, Value Objects, Domain Events, and Specifications
- **CQRS Pattern** - Command and Query Responsibility Segregation with dedicated buses
- **Repository Pattern** - Clean data access abstractions with filtering, sorting, and pagination
- **Modular Architecture** - Organize your application into self-contained modules
- **Multi-tenancy Support** - Built-in tenant resolution strategies (subdomain, header, path)

### Event Sourcing (v2.0+)

[](#event-sourcing-v20)

- **Event Store** - Persist all domain events with database and in-memory implementations
- **Event-Sourced Aggregates** - Rebuild state from event streams with automatic rehydration
- **Snapshots** - Performance optimization for aggregates with many events
- **Projections** - Build read models from event streams for optimized queries
- **Temporal Queries** - Query events by date range, type, or aggregate

### Infrastructure & Tools

[](#infrastructure--tools)

- **HTTP Layer Integration** - Built on Symfony HttpFoundation with support for PHP-FPM and FrankenPHP
- **Authentication & Authorization** - Role-based access control with policy support
- **OpenAPI Documentation** - Automatic API documentation generation with PHP attributes
- **Observability & Metrics** - Track performance with counters, gauges, histograms, and timers
- **CLI Tools** - 30+ console commands for code generation, event management, and more
- **Testing Utilities** - In-memory implementations and test helpers

Requirements
------------

[](#requirements)

- PHP 8.2 or higher
- Composer

Installation
------------

[](#installation)

```
composer require luminor/luminor

# Global installation to use Luminor CLI tools (luminor new)
composer global require luminor/luminor
```

Quick Start
-----------

[](#quick-start)

```