agnostic-domain/mapping

Simplify the hydration and extraction of agnostic domain objects

1.0 2020-03-29 17:36 UTC

Requires

• php: ^7.4

Requires (Dev)

• doctrine/orm: ^2.7.1
• friendsofphp/php-cs-fixer: ^2.16.1
• phpstan/phpstan: ^0.12.14
• phpunit/phpunit: ^9.0.1
• ramsey/uuid: ^3.9.3

MIT

• Daniel Iwaniec

README

Simplify the hydration and extraction of agnostic domain objects

Rationale

According to DDD domain should be guarded against external constraints and let's say agnostic. Most ORMs impose constraints in order to work properly and even better ones aren't free from the object-relational impedance mismatch. Assuming that you are ruling out event sourcing and other alternatives (for whatever reason) and still want to use ORM while having clean domain you need to decouple them. This decoupling comes with the cost of mapping between two layers. The goal of this library isn't to eliminate this cost via magic and another set of framework constraints, but rather to minimize.

Key ideas

• Hydration and extraction is done via reflection.
  • Domain constructors should reflect creating a new model, not data from which it's restored.
• Objects can be mapped in many to many relation.
  • Domain shouldn't be coupled with database's tables.

Installation

composer require agnostic-domain/mapping

Getting started

Mapping data object to domain object

$article = adm(Article::class)
    ->id($data->id)
    ->title($data->title)($data);

Reverse mapping domain object to data object

$data = adm()->data($article);
$data->title = adm($article)->title();

Documentation