https://github.com/mtarld/apip-ddd

An example of hexagonal API Platform 3 implementation
https://github.com/mtarld/apip-ddd

api-platform ddd example hexagonal-architecture

Last synced: 1 day ago
JSON representation

An example of hexagonal API Platform 3 implementation

• Host: GitHub
• URL: https://github.com/mtarld/apip-ddd
• Owner: mtarld
• License: mit
• Created: 2022-03-08T08:49:23.000Z (almost 3 years ago)
• Default Branch: main
• Last Pushed: 2024-05-13T12:15:05.000Z (7 months ago)
• Last Synced: 2024-10-11T19:59:53.126Z (2 months ago)
• Topics: api-platform, ddd, example, hexagonal-architecture
• Language: PHP
• Homepage:
• Size: 322 KB
• Stars: 316
• Watchers: 21
• Forks: 55
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

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](https://api-platform.com/con/2022/conferences/domain-driven-design-with-api-platform-3/)

([slides](https://slides.com/mathiasarlaud/apip-con-ddd-api-p-3), [video](https://www.youtube.com/watch?v=SSQal3Msi9g)).

## 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

1. Run `make install` to install the project

1. Run `make start` to up your containers

1. 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](https://github.com/mtarld) with the help of [Robin Chalas](https://github.com/chalasr)