Inspired by https://github.com/dunglas/doctrine-json-odm
This is beta version of library. Main differences from Dunglas library:
- library does not store any metadata in json field;
- doctrine ODM type uses main Symfony serializer service (so you can easily extend serialization process by adding normalizers/denormalizers globally in dependency injection config);
- automatic registration of ODM types for Doctrine (using Symfony autowiring and autoconfigure features).
- Object-Document Mapping with database json types
- Doctrine 2.5+ support
- PostgreSQL 9.4+ support
- Symfony 5+ support (not tested with previous versions)
- MySQL support not tested
- Automatic registering normalizers for use with Java-like collections from ramsey/collection library
To install the library, use Composer.
composer require goodwix/doctrine-json-odmAdd lines to config/bundles.php (no automatic configuration is available for beta version).
<?php
return [
// ...
Goodwix\DoctrineJsonOdm\Bridge\Symfony\DoctrineJsonOdmBundle::class => ['all' => true],
];Create package config file config/packages/doctrine-json-odm.yaml with next content.
doctrine_json_odm:
mapping:
paths:
- '%kernel.project_dir%/src/ODM'there src/ODM is the root path for your ODM entities (like src/Entity for Doctrine).
Create entity class for ODM type in ODM-specific directory (like src/ODM) and mark it with \Goodwix\DoctrineJsonOdm\Annotation\ODM annotation.
namespace App\ODM;
use Goodwix\DoctrineJsonOdm\Annotation\ODM;
/**
* @ODM()
*/
class Document
{
/** @var string */
public $title;
/** @var string */
public $description;
}Create doctrine entity class with field type App\ODM\Document.
namespace App\Entity;
use Doctrine\ORM\Mapping as ORM;
use App\ODM\Document;
/**
* @ORM\Entity()
*/
class DocumentStorage
{
/**
* @ORM\Column(type="integer")
* @ORM\Id
* @ORM\GeneratedValue(strategy="AUTO")
*
* @var int
*/
public $id;
/**
* @ORM\Column(type=Document::class, nullable=true)
*
* @var Document
*/
public $document;
}Now you can easily manage your ORM entity with ODM class field
$documentStorage = $entityManager->find(DocumentStorage::class, $id);
$documentStorage->document->title = 'ODM document title';
$documentStorage->document->description = 'ODM document description';To manually register Doctrine ODM types use ODMType::registerODMType() method.
require_once __DIR__.'/../vendor/autoload.php';
use Goodwix\DoctrineJsonOdm\Type\ODMType;
use Symfony\Component\Serializer\SerializerInterface;
class Document { }
ODMType::registerODMType(
Document::class,
new class implements SerializerInterface
{
public function serialize($data, $format, array $context = []) { /* Implement serialize() method. */ }
public function deserialize($data, $type, $format, array $context = []) { /* Implement deserialize() method. */ }
}
);You can see example of Symfony 4 application with using ODM library in this directory.
As an abstract class could not be created as an instance, each concrete children have to be mapped into the abstract class.
Indeed, the Symfony Serializer must know the real type in this case through a discriminator field to determine the real object behind
the stored data. For that, it use Symfony\Component\Serializer\Annotation\DiscriminatorMap. More info is available [here](
Maybe this way : Symfony serializer : discriminator
For example, if we have an abstract and 2 children
<?php
declare(strict_types=1);
namespace App\Whatever;
use Symfony\Component\Serializer\Annotation\DiscriminatorMap;
#### PHP8 Attribute ####
#[DiscriminatorMap(
typeProperty: 'type',
mapping: [
'myChildTypeName' => 'App\Whatever\Child',
'myChild2TypeName' => 'App\Whatever\Child2',
]
)]
####> PHP8 Attribute ####
#### PHP < PHP8 ####
/**
* @DiscriminatorMap(typeProperty="type", mapping={
* "myChildTypeName"="App\Whatever\Child",
* "myChild2TypeName"="App\Whatever\Child2"
* })
*/
####> PHP < PHP8 ####
abstract class MyAbstract
{
}
class Child extends MyAbstract
{}
class Child2 extends MyAbstract
{}You can run composer lint before pushing to repository to ensure that there are no code style errors.
Please remember to add some tests if you change library code.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent