consistence / consistence-doctrine-symfony
Symfony Bundle integrating Consistence library with Doctrine ORM
Installs: 274 862
Dependents: 0
Suggesters: 0
Security: 0
Stars: 5
Watchers: 3
Forks: 8
Open Issues: 6
Requires
- php: ~7.2
- consistence/consistence-doctrine: ~1.2|~2.0
- doctrine/doctrine-bundle: ~1.3
- symfony/config: ~3.0|~4.0
- symfony/dependency-injection: ~3.0|~4.0
- symfony/http-kernel: ~3.0|~4.0
- symfony/yaml: ~3.0|~4.0
Requires (Dev)
This package is auto-updated.
Last update: 2025-04-30 21:31:13 UTC
README
This is a Symfony bundle providing integration for the standalone package
consistence/consistence-doctrine
, if you are not using Symfony, follow instructions there.
This bundle provides integration of Consistence value objects for Doctrine ORM so that you can use them in your entities.
For now, the only integration which is needed is for Enums, see the examples below.
Usage
Enums represent predefined set of values and of course, you will want to store these values in your database as well. Since Enums
are objects and you only want to store the represented value, there has to be some mapping.
You can see it in this example where you want to store sex for your User
s:
<?php namespace Consistence\Doctrine\Example\User; class Sex extends \Consistence\Enum\Enum { public const FEMALE = 'female'; public const MALE = 'male'; }
To use the Sex
enum in your User
entity notice the type="enum<Consistence\Doctrine\Example\User\Sex>"
in ORM\Column
- this will be used for mapping the value to and from your database. You can specify any other parameters for ORM\Column
as you would usually (nullability, length...).
<?php namespace Consistence\Doctrine\Example\User; use Doctrine\ORM\Mapping as ORM; /** * @ORM\Entity() */ class User extends \Consistence\ObjectPrototype { // ... /** * @ORM\Column(type="enum<Consistence\Doctrine\Example\User\Sex>", nullable=true) * @var \Consistence\Doctrine\Example\User\Sex|null */ private $sex; // ... public function __construct( // ... Sex $sex = null // ... ) { // ... $this->sex = $sex; // ... } // ... }
Before this will work with database, we need to register Doctrine DBAL type for each enum. This can be done using the configuration:
# config/packages/consistence_doctrine.yaml consistence_doctrine: enum: dbal_types: string: - 'Consistence\Doctrine\Example\User'
We used string
because the Sex
enum uses strings for its values. There are also integer
, float
and boolean
- depending on what scalar values are used in the enum.
If you use the same enum in multiple places configure it only once.
Now everything is ready to be used, when you call flush
, only female
will be saved:
<?php namespace Consistence\Doctrine\Example\User; $user = new User( // ... Sex::get(Sex::FEMALE) // ... ); /** @var \Doctrine\ORM\EntityManager $entityManager */ $entityManager->persist($user); // when persisting User::$sex to database, `female` will be saved $entityManager->flush();
And when you retrieve the entity back from database, you will receive the Sex
enum object again:
<?php namespace Consistence\Doctrine\Example\User; /** @var \Doctrine\ORM\EntityManager $entityManager */ $user = $entityManager->find(User::class, 1); var_dump($user->getSex()); /* class Consistence\Doctrine\Example\User\Sex#5740 (1) { private $value => string(6) "female" } */
This means that the objects API is symmetrical (you get the same type as you set) and you can start benefiting from Enums advantages such as being sure, that what you get is already a valid value and having the possibility to define methods on top of the represented values.
Configuration
Configuration structure with listed default values:
# config/packages/consistence_doctrine.yaml consistence_doctrine: enum: dbal_types: boolean: [] float: [] integer: [] string: []
Installation
- Install package
consistence/consistence-doctrine-symfony
with Composer:
composer require consistence/consistence-doctrine-symfony
- Register the bundle in your application:
// config/bundles.php return [ // ... Consistence\Doctrine\SymfonyBundle\ConsistenceDoctrineBundle::class => ['all' => true], ];
- Configure needed DBAL types (see
Usage
section above).
That's all, you are good to go!