PHPackages                             swellphp/eventful - 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. swellphp/eventful

ActiveLibrary[Framework](/categories/framework)

swellphp/eventful
=================

The Eventful DDD, CQRS &amp; ES Framework.

v0.4(8y ago)012[9 issues](https://github.com/swellphp/eventful/issues)MITPHPPHP &gt;=7.1

Since Nov 11Pushed 8y ago1 watchersCompare

[ Source](https://github.com/swellphp/eventful)[ Packagist](https://packagist.org/packages/swellphp/eventful)[ RSS](/packages/swellphp-eventful/feed)WikiDiscussions master Synced 3d ago

READMEChangelogDependencies (2)Versions (7)Used By (0)

Eventful - PHP CQRS &amp; ES Framework
======================================

[](#eventful---php-cqrs--es-framework)

The aim of this project is to facilitate the development of PHP application using the Command, Query Responsibility Segregation and Event Sourcing Architecture. Together with Domain Driven Design Helpers.

It is not meant to be a one size fit all system and will possibly only be useful for developers wishing a quick start in learning these architectures.

[![Build Status](https://camo.githubusercontent.com/878ba8a6398c719a157aa0d48e549e362daab4b7ee6f4e46ed8be43f94f840b0/68747470733a2f2f7472617669732d63692e6f72672f7377656c6c7068702f6576656e7466756c2e7376673f6272616e63683d6d61737465722537442e706e673f6272616e63683d6d6173746572)](https://travis-ci.org/swellphp/eventful.svg?branch=master) [![Coverage Status](https://camo.githubusercontent.com/ce4cdd7c7eaacacbea3c86a3bc9cfe7a402d7340a97996bd8117d3058ea24694/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f7377656c6c7068702f6576656e7466756c2f62616467652e7376673f6272616e63683d6d6173746572)](https://coveralls.io/github/swellphp/eventful?branch=master)

Under Development
-----------------

[](#under-development)

This project is under initial development and should definitely not be used in any production systems.

Problems I'm trying to solve using this framework based on what I didn't like using other similar frameworks and helpers.
-------------------------------------------------------------------------------------------------------------------------

[](#problems-im-trying-to-solve-using-this-framework-based-on-what-i-didnt-like-using-other-similar-frameworks-and-helpers)

1. I want that my models are completely independent from the framework. The framework should not be intrusive because most projects require custom implementations and structures.
2. I want to easily be able to apply a TDD approach when developing any application.
3. I want it to integrate to Laravel.

Components and features required for the initial release.
---------------------------------------------------------

[](#components-and-features-required-for-the-initial-release)

- Installation via Composer. [GH-2](https://github.com/swellphp/eventful/issues/2)
- Command and Command Handling. [GH-3](https://github.com/swellphp/eventful/issues/3)
- Event Bus, subscribe and dispatch. [GH-4](https://github.com/swellphp/eventful/issues/4)
- Event Sourcing. [GH-19](https://github.com/swellphp/eventful/issues/19)
- Event Store. [GH-5](https://github.com/swellphp/eventful/issues/5)
- Event Sourced Infrastructure Abstractions. [GH-6](https://github.com/swellphp/eventful/issues/6)
- Read Model. [GH-7](https://github.com/swellphp/eventful/issues/7)
- Domain Driven Design Helpers such as VOs, Aggregate and Entities. [GH-8](https://github.com/swellphp/eventful/issues/8)
- Scenario based testing helpers. [GH-16](https://github.com/swellphp/eventful/issues/16)
- Extraction of extensible classes within the custom Model to be used as adaptors for the ability of swapping such dependencies and also adding custom code on a per project basis. [GH-9](https://github.com/swellphp/eventful/issues/9)
- Online Documentation using github projects. [GH-11](https://github.com/swellphp/eventful/issues/11)
- Other features to be planned as we go along developing this release.

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

[](#installation)

Via composer:

`composer require swellphp/eventful`

Documentation
-------------

[](#documentation)

- [Command Handling Documentation](https://github.com/swellphp/eventful/blob/master/src/Eventful/Command/README.md)
- [Event Bus Documentation](https://github.com/swellphp/eventful/blob/master/src/Eventful/Event/README.md)

Other components are in progress of being developed.

Contributing
------------

[](#contributing)

In progress. However, feel free to fork this repository and submit pull requests.

All contributions must include tests for the code added, ability for developers to test their code by proving testing helpers when appropriate.

All contributions must also include an example and in case of full components (in their own directory) a Readme file documenting it's usage.

Issues must be created in advance of the development work and commit messages must mention the issue key in this format "GH-X".

License
-------

[](#license)

Open Source under the MIT Licence.

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity5

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~1 days

Total

4

Last Release

3104d ago

PHP version history (2 changes)v0.1PHP &gt;=5.7

v0.2PHP &gt;=7.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/f389eb3354cf1c705bcda9ec2c1dec604aabc99eeb278c50a2b7aad3a8a99373?d=identicon)[keithmifsud](/maintainers/keithmifsud)

---

Top Contributors

[![keithmifsud](https://avatars.githubusercontent.com/u/2071560?v=4)](https://github.com/keithmifsud "keithmifsud (55 commits)")

---

Tags

Domain Driven Designdddevent sourcingcqrsEventful

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/swellphp-eventful/health.svg)

```
[![Health](https://phpackages.com/badges/swellphp-eventful/health.svg)](https://phpackages.com/packages/swellphp-eventful)
```

###  Alternatives

[broadway/broadway

Infrastructure and testing helpers for creating CQRS and event sourced applications.

1.5k2.0M53](/packages/broadway-broadway)[broadway/broadway-bundle

Symfony bundle for broadway/broadway.

68853.8k7](/packages/broadway-broadway-bundle)[nwidart/laravel-broadway

A Laravel adapter for the Broadway ES/CQRS package.

12315.0k](/packages/nwidart-laravel-broadway)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
