PHP 5.4+ port of the cargo sample used in Eric Evans Domain-Driven Design book
We want to show the PHP way of implementing Domain-Driven Design with the help of
the original Cargo sample used in Eric Evans book
Domain-Driven Design: Tackling Complexity in the Heart of Software.
This has already been done using java and a C# version is also available.
It is not the one way to apply DDD, but should help you understand the theory and gives you a starting point. Also see the Caveats of the java implementation. The same applies for our version.
The PHP port is work in progress. Your welcome to fork the repo and help finishing the cargo sample application.
The application layer is based on ZF2 and we use Doctrine2 to persist our aggregates. This would be a common combination in a large PHP project but both frameworks are not required. They just make our life easier and let us focus on the Domain-Driven Design implementation. Both can be replaced with any other PHP based components.
To go with you when you read the book, our sample has a release of each chapter. So you can
simply git checkout ChapterOne and you only get the starting view of the domain
with just to entities Cargo and Voyage. Our application evolves chapter by chapter
the more knowledge we get about the domain. Each chapter ships with it's own review, where you can find additional information about the implementation, tips and tricks and many more.
See the Installation file.
Check our collection of DDD Tools and Libs.
If you want to share your experience with other DDD enthusiasts or want to ask a question about DDD then the DDDinPHP google group is good place to do so.
You can find more DDD stuff like interesting articles and related libraries on the PhpFriendsOfDdd/state-of-the-union project.
There is no problem if you don't know the structure of a ZF2 application. All the important parts like the domain and the infrastructure implementation can be found in the namespace of the CargoBackend module.
Note: Project structure has changed in ChapterFour. In ChapterOne - ChapterThree the domain and infrastructure classes were included in the Application module!
All features of the application are described in feature files. You can find them in the features folder of the project. We make use of Behat and Mink to test our business expectations.
You can run the feature tests by navigating to the project root and start the selenium server shipped with the sample app:
java -jar bin/selenium-server-standalone-2.37.0.jar
After the server started successfully open another console, navigate to project root again and run Behat with the command php bin/behat.
*Note: If it does not work, check that the behat file is executable.
Unit Tests are of course also available. You can find them in module/CargoBackend/tests.
Got to the directory and simply run phpunit.
Note: Project structure has changed in ChapterFour. In ChapterOne - ChapterThree the test classes were included in the Application module!
If you have any problems with the application please let me know and send me an email kontakt[at]codeliner[dot]ws or open a GitHub issue.
Same applies if you have a question or a feature wish.
Maybe I've missed a concept that you hoped to find in the example.
The chapter overview has moved to the PHP DDD Cargo Sample project page
See the CONTRIBUTING file.
- Provide vagrant support for simple application set up [not started]
- Improve project pages (include reviews, DDD tools, ...) [not started]
- Review of ChapterFour [in progress]
- Implement ChapterFive [not started]
- Switch to ValueObjects and use VOs whenever possible
- Add reroute Cargo use case
- Add HandlingEvents
- Add delivery progress use cases