PHP > Symfony 5 DDD ES CQRS backend
DDD, CQRS and Event Sourcing app using Symfony and PHP 8.
Symfony 7 ES CQRS Boilerplate
A boilerplate demonstrating Domain-Driven Design (DDD), Command Query Responsibility Segregation (CQRS), and Event Sourcing patterns using Symfony 7 and PHP 8.3.
This is a long living repository that started at v4 and was upgraded to each major version since then. You can find older versions at the following branches:
Documentation
- Command and Query Buses
- Creating Use Cases
- Adding Projections
- Async Processing
- UI Workflow
- Xdebug Configuration
- Kubernetes Deployment
Architecture
Implementations
- Environment in Docker
- Symfony Messenger
- Event Store
- Read Model
- Async Event subscribers
- Rest API
- Web UI (A Terrible UX/UI)
- Event Store Rest API
- Swagger API Doc
Use Cases
User
- Sign up
- Change Email
- Sign in
- Logout
Stack
- PHP 8.3
- Symfony 7
- MySQL 8.0
- Elasticsearch & Kibana 7.11.0
- RabbitMQ 3
Project Setup
| Action | Command |
|---|---|
| Setup | make start |
| Run Tests | make phpunit |
| Static Analysis | make phpstan |
| Code Style | make cs |
| PHP Shell | make s=php sh |
| Xdebug | make xoff/xon |
| Build Artifacts | make artifact |
PHPStorm integration
PHPSTORM has native integration with Docker compose. That's nice but will stop your php container after run the test scenario. That's not nice when using fpm. A solution could be use another container just for that purpose but is way slower and I don't want. For that reason I use ssh connection.
IMPORTANT
ssh in the container it's ONLY for that reason and ONLY in the DEV TAG, if you've ssh installed in your production container, you're doing it wrong...*
Click here for the detailed instructions about how to setup the PHP remote interpreter in PHPStorm.
If you're already familiar with it, here a quick configuration reference:
| Host | Direction |
|------------------ |-------------- |
| Docker 4 mac | localhost |
| Dinghy | $ dinghy ip |
Port: 2323
Filesystem mapping: {PROJECT_PATH} -> /app
Xdebug
To ease your development process, you can use Xdebug with PHPSTORM.
Add a Docker interpreter
Enable Xdebug listenning. Don't forget to also activate Xdebug helper from your browser.
Additionally, you can check
Break at first line in PHP scriptsto ensure your debug is working.Make a request from you API at http://127.0.0.1/api/doc for example. You should see this popup:
Click on
Acceptand you should be ready to debug ! Start placing breakpoints on your code and enjoy debugging !
Note for Windows users:
You might need to update
docker-os=todocker-os=windowsin Makefile or specify its value on command line like$ make start docker-os=windows.
Contributors ✨
Thanks goes to these wonderful people (emoji key):
 Luis 💻 |
 Kajetan 💻 |
 Krzysztof Kowalski 💻 |
 Patryk Woziński 💻 |
 jon-ht 💻 |
This project follows the all-contributors specification. Contributions of any kind welcome!