This library is design to help you to build your application with a Domain Design Development approach.
It is well integrated with:
- Symfony >= 4.3 (for >=3.3 compatibility, install the version 1.5 of the domain component)
- ApiPlatform >= 2.1
- Doctrine >=2.5
But you can use it with any PHP project.
Here are some slides that explain how we get there.
Domain Events:
- Domain event dispatcher
- Injection of the dispatcher in Doctrine entities
- Symfony serializer integration
- Learn how do more with our cookbooks
This library is build to allow you to use Doctrine models as Domain model. This has some cost: you can't instantiate domain model by hand anymore. This means that you need a factory for any of the usage of your domain model.
This component provides the implementation for Symfony serializer and Doctrine. For your own
needs you should use the class (service if you use the bundle) Biig\Component\Domain\Model\Instantiator\Instantiator
.
composer require biig/domain
class YourModel extends DomainModel
{
public const CREATION = 'creation';
public function __construct()
{
$this->dispatch(new DomainEvent($this), self::CREATION);
}
}
class DomainRule implements DomainRuleInterface
{
public static function on()
{
return YourModel::CREATION;
}
public function execute(DomainEvent $event)
{
// Do Something on your model creation
}
}
As your model needs a dispatcher you need to call the setDispatcher()
method any time you create a new instance of your model. To avoid doing this manually you can use the Instantiator
that the library provides.
It doesn't use the constructor to add the dispatcher because in PHP you can create objects without the constructor. For instance, that's what Doctrine does.
Use the bundle :
<?php
// config/bundles.php
return [
// ...
Biig\Component\Domain\Integration\Symfony\DomainBundle::class => ['all' => true],
];
Learn more about Symfony Integration
Version | Status | Documentation | Symfony Version | PHP Version |
---|---|---|---|---|
1.x | Maintained | v1 | '>= 3.3 && <5' | '>= 7.1' |
2.x | Latest | v2 | '>= 4.3' | '>= 7.1' |