包简介

Patches doctrine/orm to allow usage of nullable embeddables

README 文档

README

As soon as you start using embeddable value objects in your Doctrine entities there is chance you will run in the problem, that Doctrine will instantiate value objects even when the corressponding value in the database is null. This will lead to typing-related PHP errors.

Basic example:

<?php

declare(strict_types=1);

class ValueObject
{
    private $value; // Doctrine will set this property to null on hydration

    public function __construct(string $value)
    {
        $this->value = $value;    
    }

    public function __toString() : string
    {
        return $this->value; // This will be null and throw an error
    }
}

If you want to use PHP 7.4 typed properties:

<?php

declare(strict_types=1);

class ValueObject
{
    private string $value; // Doctrine will try to set this property to null on hydration and an error will be thrown

    public function __construct(string $value)
    {
        $this->value = $value;    
    }

    public function __toString() : string
    {
        return $this->value;
    }
}

This problem was discussed in the doctrine/orm repository issue: doctrine/orm#4568

The current consensus is that this feature will land in the 3.x versions only.

So this leaves you with the following options:

Make your value objects properties nullable.

This will break the entity and value objects invariants and introduce a lot of unnecessary checks in your code:

<?php

declare(strict_types=1);

class ValueObject
{
    private ?string $value;

    public function __construct(string $value)
    {
        if ($value === '') {
            throw new InvalidArgumentException('ValueObject value cannot be an empty string');
        }

        $this->value = $value;    
    }

    public function __toString() : string
    {
        return (string) $this->value; // invariant broken, you will get an empty string     
    }
}

Use a Doctrine lifecycle callback to reset the entity properties to null after hydration.

You will still need to set the value object's properties as nullable to avoid errors during hydration and your nullable value objects will need some logic, for example implement a special interface, to allow the lifecycle callback to determine whether the hydrated value is null or not.

<?php

declare(strict_types=1);

interface NullableValueObjectInterface
{
    public function isNull() : bool;
}

class ValueObject implements NullableValueObjectInterface
{
    private ?string $value;

    public function __construct(string $value)
    {
        $this->value = $value;    
    }

    public function isNull() : bool
    {
        return $this->value === null;
    }

    public function __toString() : string
    {
        return $this->value;
    }
}

You will also need to configure each nullable value object for each entity to avoid running the lifecycle callback for all entity properties.

<?php

use Doctrine\Common\EventManager;
use Doctrine\ORM\Events;
use Tarifhaus\Doctrine\ORM\NullableEmbeddableListenerFactory;

$listener = NullableEmbeddableListenerFactory::createWithClosureNullator();
$listener->addMapping('App\Domain\User\Model\UserProfile', 'address');

$evm = new EventManager();
$evm->addEventListener([Events::postLoad], $listener);

If you choose this path, there is an implementation available: https://github.com/tarifhaus/doctrine-nullable-embeddable

Fork Doctrine to implement your own hydration mechanism

This is pretty straightforward and the implications will be in maintaining your own fork and keeping up with the upstream changes.

Override specific Doctrine classes with your own

This is what this package is doing.

It will install doctrine/orm of a specific version. The version is always the same as of this package and is locked by it, so if you want to update Doctrine you will need to update this package to the same version as the Doctrine version you want. This locking is needed to ensure that there are no changes to the files this package is patching.

After installing doctrine/orm, a patch will be applyed to the Doctrine class Doctrine/ORM/Mapping/ReflectionEmbeddedProperty using https://github.com/cweagans/composer-patches.

You can review the contents of this patch in patch/nullable_embeddables.patch

It works by analyzing the types of the properties of the entity and the value-object. If the entity property containing the value-object is declared as nullable and none of the value-object's properties that are not declared nullable get null values from the database - then the entity property will be hydrated with the value object. All other cases are considered an invalid state based on the provided typing and will result in hydrating to null on the corresponding property of the entity.

The tradeoffs of this approach will be:

You can't update Doctrine directly, only update it with this package
You will need PHP 7.4
Your entities properties containing nullable value objects must be typed
Your entities properties containing nullable value objects must be nullable
Your nullable value objects properties must be typed

A working example would look like this:

<?php

declare(strict_types=1);

class Entity
{
    private ?ValueObject $nullableValueObject;

    public function setValueObject(string $value) : void
    {
        $this->nullableValueObject = new ValueObject($value);
    }

    public function getValueObject() : ?ValueObject
    {
        return $this->nullableValueObject;
    }
}

class ValueObject
{
    private string $value;

    public function __construct(string $value)
    {
        $this->value = $value;    
    }

    public function __toString() : string
    {
        return $this->value;    
    }
}

If you choose this path, you can install this package in the following steps:

add to your composer.json:

{
    "extra": {
        "enable-patching": true
    }
}

Then depending on the version of doctrine/orm you want to use:

run composer require sspat/doctrine-nullable-embeddables:v2.20.0 doctrine/orm:2.20.0
run composer require sspat/doctrine-nullable-embeddables:v2.19.8 doctrine/orm:2.19.8
run composer require sspat/doctrine-nullable-embeddables:v2.19.7 doctrine/orm:2.19.7
run composer require sspat/doctrine-nullable-embeddables:v2.19.6 doctrine/orm:2.19.6
run composer require sspat/doctrine-nullable-embeddables:v2.19.5 doctrine/orm:2.19.5
run composer require sspat/doctrine-nullable-embeddables:v2.19.4 doctrine/orm:2.19.4
run composer require sspat/doctrine-nullable-embeddables:v2.19.3 doctrine/orm:2.19.3
run composer require sspat/doctrine-nullable-embeddables:v2.19.2 doctrine/orm:2.19.2
run composer require sspat/doctrine-nullable-embeddables:v2.19.1 doctrine/orm:2.19.1
run composer require sspat/doctrine-nullable-embeddables:v2.19.0 doctrine/orm:2.19.0
run composer require sspat/doctrine-nullable-embeddables:v2.18.3 doctrine/orm:2.18.3
run composer require sspat/doctrine-nullable-embeddables:v2.18.2 doctrine/orm:2.18.2
run composer require sspat/doctrine-nullable-embeddables:v2.18.1 doctrine/orm:2.18.1
run composer require sspat/doctrine-nullable-embeddables:v2.18.0 doctrine/orm:2.18.0
run composer require sspat/doctrine-nullable-embeddables:v2.17.5 doctrine/orm:2.17.5
run composer require sspat/doctrine-nullable-embeddables:v2.17.4 doctrine/orm:2.17.4
run composer require sspat/doctrine-nullable-embeddables:v2.17.3 doctrine/orm:2.17.3
run composer require sspat/doctrine-nullable-embeddables:v2.17.2 doctrine/orm:2.17.2
run composer require sspat/doctrine-nullable-embeddables:v2.17.1 doctrine/orm:2.17.1
run composer require sspat/doctrine-nullable-embeddables:v2.17.0 doctrine/orm:2.17.0
run composer require sspat/doctrine-nullable-embeddables:v2.16.3 doctrine/orm:2.16.3
run composer require sspat/doctrine-nullable-embeddables:v2.16.2 doctrine/orm:2.16.2
run composer require sspat/doctrine-nullable-embeddables:v2.16.1 doctrine/orm:2.16.1
run composer require sspat/doctrine-nullable-embeddables:v2.16.0 doctrine/orm:2.16.0
run composer require sspat/doctrine-nullable-embeddables:v2.15.5 doctrine/orm:2.15.5
run composer require sspat/doctrine-nullable-embeddables:v2.15.4 doctrine/orm:2.15.4
run composer require sspat/doctrine-nullable-embeddables:v2.15.3 doctrine/orm:2.15.3
run composer require sspat/doctrine-nullable-embeddables:v2.15.2 doctrine/orm:2.15.2
run composer require sspat/doctrine-nullable-embeddables:v2.15.1 doctrine/orm:2.15.1
run composer require sspat/doctrine-nullable-embeddables:v2.15.0 doctrine/orm:2.15.0
run composer require sspat/doctrine-nullable-embeddables:v2.14.3 doctrine/orm:2.14.3
run composer require sspat/doctrine-nullable-embeddables:v2.14.2 doctrine/orm:2.14.2
run composer require sspat/doctrine-nullable-embeddables:v2.14.1 doctrine/orm:2.14.1
run composer require sspat/doctrine-nullable-embeddables:v2.14.0 doctrine/orm:2.14.0
run composer require sspat/doctrine-nullable-embeddables:v2.13.5 doctrine/orm:2.13.5
run composer require sspat/doctrine-nullable-embeddables:v2.13.4 doctrine/orm:2.13.4
run composer require sspat/doctrine-nullable-embeddables:v2.13.3 doctrine/orm:2.13.3
run composer require sspat/doctrine-nullable-embeddables:v2.13.2 doctrine/orm:2.13.2
run composer require sspat/doctrine-nullable-embeddables:v2.13.1 doctrine/orm:2.13.1
run composer require sspat/doctrine-nullable-embeddables:v2.13.0 doctrine/orm:2.13.0
run composer require sspat/doctrine-nullable-embeddables:v2.12.4 doctrine/orm:2.12.4
run composer require sspat/doctrine-nullable-embeddables:v2.12.3 doctrine/orm:2.12.3
run composer require sspat/doctrine-nullable-embeddables:v2.12.2 doctrine/orm:2.12.2
run composer require sspat/doctrine-nullable-embeddables:v2.12.1 doctrine/orm:2.12.1
run composer require sspat/doctrine-nullable-embeddables:v2.12.0 doctrine/orm:2.12.0
run composer require sspat/doctrine-nullable-embeddables:v2.11.3 doctrine/orm:2.11.3
run composer require sspat/doctrine-nullable-embeddables:v2.11.2 doctrine/orm:2.11.2
run composer require sspat/doctrine-nullable-embeddables:v2.11.1 doctrine/orm:2.11.1
run composer require sspat/doctrine-nullable-embeddables:v2.11.0 doctrine/orm:2.11.0
run composer require sspat/doctrine-nullable-embeddables:v2.10.5 doctrine/orm:2.10.5
run composer require sspat/doctrine-nullable-embeddables:v2.10.4 doctrine/orm:2.10.4
run composer require sspat/doctrine-nullable-embeddables:v2.10.3 doctrine/orm:2.10.3
run composer require sspat/doctrine-nullable-embeddables:v2.10.2 doctrine/orm:2.10.2
run composer require sspat/doctrine-nullable-embeddables:v2.10.1 doctrine/orm:2.10.1
run composer require sspat/doctrine-nullable-embeddables:v2.10.0 doctrine/orm:2.10.0
run composer require sspat/doctrine-nullable-embeddables:v2.9.6 doctrine/orm:2.9.6
run composer require sspat/doctrine-nullable-embeddables:v2.9.5 doctrine/orm:2.9.5
run composer require sspat/doctrine-nullable-embeddables:v2.9.4 doctrine/orm:2.9.4
run composer require sspat/doctrine-nullable-embeddables:v2.9.3 doctrine/orm:2.9.3
run composer require sspat/doctrine-nullable-embeddables:v2.9.2 doctrine/orm:2.9.2
run composer require sspat/doctrine-nullable-embeddables:v2.9.1 doctrine/orm:2.9.1
run composer require sspat/doctrine-nullable-embeddables:v2.9.0 doctrine/orm:2.9.0
run composer require sspat/doctrine-nullable-embeddables:v2.8.5 doctrine/orm:2.8.5
run composer require sspat/doctrine-nullable-embeddables:v2.8.4 doctrine/orm:2.8.4
run composer require sspat/doctrine-nullable-embeddables:v2.8.3 doctrine/orm:2.8.3
run composer require sspat/doctrine-nullable-embeddables:v2.8.2 doctrine/orm:2.8.2
run composer require sspat/doctrine-nullable-embeddables:v2.8.1 doctrine/orm:2.8.1
run composer require sspat/doctrine-nullable-embeddables:v2.8.0 doctrine/orm:2.8.0
run composer require sspat/doctrine-nullable-embeddables:v2.7.5 doctrine/orm:2.7.5
run composer require sspat/doctrine-nullable-embeddables:v2.7.4 doctrine/orm:2.7.4
run composer require sspat/doctrine-nullable-embeddables:v2.7.3 doctrine/orm:2.7.3
run composer require sspat/doctrine-nullable-embeddables:v2.7.2 doctrine/orm:2.7.2
run composer require sspat/doctrine-nullable-embeddables:v2.7.1 doctrine/orm:2.7.1
run composer require sspat/doctrine-nullable-embeddables:v2.7.0 doctrine/orm:2.7.0

sspat/doctrine-nullable-embeddables 适用场景与选型建议

sspat/doctrine-nullable-embeddables 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 2.63k 次下载、GitHub Stars 达 4，最近一次更新时间为 2019 年 12 月 03 日，在 PHP 生态内属于活跃度较高的组件。

它主要适用于以下技术方向：「doctrine」「embeddable」「nullable」等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。

我们在过去多个企业项目中使用过 sspat/doctrine-nullable-embeddables 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 sspat/doctrine-nullable-embeddables 我们能提供哪些服务？

定制开发 / 二次开发

基于 sspat/doctrine-nullable-embeddables 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

与 sspat/doctrine-nullable-embeddables 相关的其它包

同方向 / 同关键字的高下载量 PHP Composer 包推荐，方便对比选型：

php-extended/php-optionality-interface 0

A library to specify optionalities in modelisations

chamber-orchestra/metadata-bundle 0

Symfony bundle for extending Doctrine ORM entities with custom attribute-driven metadata — cacheable mapping, embedded entity support, and autoconfigured drivers

gal-digital-gmbh/pimcore-simple-migration 0

Make pimcore migration simple

arkitecht/laravel-nullable 0

Laravel 5 - Add nullable columns to models

snapshotpl/tactician-doctrine 0

Plugins for Tactician commands using Doctrine, like wrapping every command in a transaction

groupone/marketplace 0

Embeddable React-based marketplace UI for WordPress plugins. Consumed via Composer + Mozart; ships a webpack-built frontend and an MVC PHP backend.

sspat/doctrine-nullable-embeddables

包简介

关键字：

README 文档

README

sspat/doctrine-nullable-embeddables 适用场景与选型建议

与 sspat/doctrine-nullable-embeddables 相关的其它包

统计信息

GitHub 信息

其他信息