How do I run the Behat feature tests in PHP DDD Cargo Sample?

First, start the selenium server with 'java -jar selenium-server-standalone-2.46.0.jar' from the project root. Then, in another terminal, run 'php bin/behat' to execute the tests, as detailed in the 'Behavior Driven Design' section of the README.

Is PHP DDD Cargo Sample production ready?

No, it's primarily an educational reference implementation. The README mentions caveats from the original Java version and lacks production features like authentication, making it best for learning rather than direct deployment.

What are the main differences between PHP DDD Cargo Sample and the original Java version?

This port uses modern PHP 7 with strict type hints, PSR middleware via Zend Expressive, and Doctrine ORM with embeddables for value objects. It focuses on the PHP ecosystem, while the Java version is older and may have different tooling and patterns.

How can I use Doctrine ORM with DDD value objects in my own project?

Study the sample's use of Doctrine embeddables for value objects, such as in the cargo domain. The annotated structure docs show how to map immutable objects, but note that this requires Doctrine 2.5+ and careful configuration.

PHP DDD Cargo Sample or Symfony DDD examples: which one should I learn from?

Choose PHP DDD Cargo Sample for a pure, framework-agnostic DDD reference with modern PHP 7. For a more integrated, production-oriented approach with Symfony's ecosystem, look at Symfony-based DDD projects, but be prepared for additional complexity.

How to install PHP DDD Cargo Sample with Docker?

Follow the Dockerized installation guide in the docs, which provides steps to set up containers. However, ensure you have Docker installed and be aware that it might require additional configuration for local development environments.

Does PHP DDD Cargo Sample support PHP 8?

No, the project is built for PHP 7 with strict type hints, as stated in the README. For PHP 8 compatibility, you might need to fork or update the codebase, as it hasn't been officially maintained for newer versions.

Eric Evans DDD Cargo Sample — PHP DDD Cargo Implementation

What is Eric Evans DDD Cargo Sample?

PHP DDD Cargo Sample is a reference implementation of the cargo shipping domain from Eric Evans' Domain-Driven Design book, built with PHP 7. It demonstrates how to apply DDD tactical patterns—like aggregates, entities, and value objects—in a modern PHP application to manage complex business logic in the shipping industry.

Target Audience

PHP developers and software architects learning or applying Domain-Driven Design, particularly those seeking a concrete, working example of DDD patterns in PHP with modern frameworks and tools.

Value Proposition

Developers choose this project because it provides a complete, well-structured PHP 7 implementation of a classic DDD case study, using up-to-date technologies like Zend Expressive and Doctrine ORM. It bridges the gap between DDD theory and practice, offering tested, educational code rather than just theoretical concepts.

PHP 7 Version of the cargo sample used in Eric Evans DDD book

Use Cases

Best For

Learning Domain-Driven Design tactical patterns in PHP
Reference implementation for DDD aggregates and value objects
Studying integration of Doctrine ORM with DDD concepts
Example of Behavior-Driven Design with Behat in PHP
Modern PHP 7 application architecture with middleware
Educational resource for DDD workshops or training

Not Ideal For

Production teams needing a turnkey solution with built-in authentication, error handling, and long-term support
Developers seeking a lightweight MVC framework without the complexity of DDD aggregates and value objects
Projects running on PHP versions older than 7 or requiring PHP 8+ compatibility out of the box
Teams unfamiliar with Domain-Driven Design who prefer conventional, rapid application development patterns

Pros & Cons

Pros

Modern PHP Standards

Uses PHP 7 strict type hints and PSR-7/15 middleware with Zend Expressive, ensuring code clarity and interoperability, as highlighted in the 'What Is New?' section of the README.

Practical DDD Implementation

Demonstrates DDD tactical patterns like aggregates and value objects with Doctrine ORM embeddables, providing a concrete reference to translate theory into working code.

Behavior-Driven Testing

Features are described and tested with Behat and Mink, validating business expectations directly, as shown in the 'Behavior Driven Design' section with example feature files.

Educational Reference

Offers a complete, annotated project structure and documentation, making it an effective learning resource for DDD workshops or self-study in PHP.

Cons

Outdated Technology Stack

Based on PHP 7 and older versions of Zend Expressive and Doctrine, which may lack compatibility with current PHP 8+ ecosystems and security updates, limiting modern adoption.

Complex Setup for Beginners

Requires running a selenium server for Behat tests and has multiple installation steps, as noted in the documentation, which can be cumbersome for those new to the toolchain.

Limited Production Readiness

Admitted as an educational reference with caveats from the original Java version, missing features like authentication, scalability, and error handling needed for real-world use.

Frequently Asked Questions

What is Eric Evans DDD Cargo Sample?

Target Audience

PHP developers and software architects learning or applying Domain-Driven Design, particularly those seeking a concrete, working example of DDD patterns in PHP with modern frameworks and tools.

Value Proposition

Use Cases

Best For

Learning Domain-Driven Design tactical patterns in PHP
Reference implementation for DDD aggregates and value objects
Studying integration of Doctrine ORM with DDD concepts
Example of Behavior-Driven Design with Behat in PHP
Modern PHP 7 application architecture with middleware
Educational resource for DDD workshops or training

Not Ideal For

Production teams needing a turnkey solution with built-in authentication, error handling, and long-term support
Developers seeking a lightweight MVC framework without the complexity of DDD aggregates and value objects
Projects running on PHP versions older than 7 or requiring PHP 8+ compatibility out of the box
Teams unfamiliar with Domain-Driven Design who prefer conventional, rapid application development patterns

Pros & Cons

Pros

Modern PHP Standards

Uses PHP 7 strict type hints and PSR-7/15 middleware with Zend Expressive, ensuring code clarity and interoperability, as highlighted in the 'What Is New?' section of the README.

Practical DDD Implementation

Demonstrates DDD tactical patterns like aggregates and value objects with Doctrine ORM embeddables, providing a concrete reference to translate theory into working code.

Behavior-Driven Testing

Features are described and tested with Behat and Mink, validating business expectations directly, as shown in the 'Behavior Driven Design' section with example feature files.

Educational Reference

Offers a complete, annotated project structure and documentation, making it an effective learning resource for DDD workshops or self-study in PHP.

Cons

Outdated Technology Stack

Based on PHP 7 and older versions of Zend Expressive and Doctrine, which may lack compatibility with current PHP 8+ ecosystems and security updates, limiting modern adoption.

Complex Setup for Beginners

Requires running a selenium server for Behat tests and has multiple installation steps, as noted in the documentation, which can be cumbersome for those new to the toolchain.

Limited Production Readiness

Admitted as an educational reference with caveats from the original Java version, missing features like authentication, scalability, and error handling needed for real-world use.

Frequently Asked Questions

Eric Evans DDD Cargo Sample

What is Eric Evans DDD Cargo Sample?

Overview

Use Cases

Best For

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions

Related Projects

Found a gem we're missing?

Eric Evans DDD Cargo Sample

What is Eric Evans DDD Cargo Sample?

Overview

Use Cases

Best For

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions

Related Projects

Found a gem we're missing?