search

mtarld / apip-ddd

An example of hexagonal API Platform 3 implementation
MIT License
322 stars 55 forks source link
api-platform ddd example hexagonal-architecture

readme

Domain Driven Design and API Platform 3

An example project of Domain Driven Design using API Platform 3 and following the hexagonal architecture.

This example has been explained during the API Platform conference 2022 (slides, video).

Getting started

If you want to try to use and tweak that example, you can follow these steps:

  1. Run git clone https://github.com/mtarld/apip-ddd to clone the project
  2. Run make install to install the project
  3. Run make start to up your containers
  4. Visit https://localhost/api and play with your app!

Contributing

That implementation is pragmatic and far for being uncriticable. It's mainly an conceptual approach to use API Platform in order to defer operations to command and query buses.

It could and should be improved, therefore feel free to submit issues and pull requests if something isn't relevant to your use cases or isn't clean enough.

To ensure that the CI will succeed whenever contributing, make sure that either static analysis and tests are successful by running make ci

Authors

Mathias Arlaud with the help of Robin Chalas