DoctrineExtensions 跨对象映射器(Reference)行为详解-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_01067/article/details/148549483

DoctrineExtensions 跨对象映射器(Reference)行为详解

DoctrineExtensions Doctrine2 behavioral extensions, Translatable, Sluggable, Tree-NestedSet, Timestampable, Loggable, Sortable 项目地址: https://gitcode.com/gh_mirrors/do/DoctrineExtensions

概述

DoctrineExtensions 中的 Reference 行为提供了一种强大的跨对象映射机制，允许开发者在不同类型的 Doctrine 实体之间建立关联关系。这种功能特别适用于混合使用 Doctrine ORM 和 ODM 的项目场景，实现了传统关系型数据库与文档型数据库之间的无缝交互。

核心概念

Reference 行为主要包含两种关联类型：

ReferenceOne：表示一对一关联关系
ReferenceMany：表示一对多关联关系

这种映射机制打破了传统 ORM 只能在同类实体间建立关联的限制，为复杂系统架构提供了更大的灵活性。

配置选项详解

拥有方(Ownning Side)配置

type：指定关联类型，可以是"entity"(ORM实体)或"document"(ODM文档)
class：关联的目标类全限定名
inversedBy：指定反向关联的属性名(可选)
identifier：存储关联对象ID的属性名

反向方(Inverse Side)配置

type：指定关联类型
class：关联的目标类全限定名
mappedBy：指定拥有方的属性名

实际应用示例

混合持久化场景

考虑一个电子商务系统，其中产品信息存储在MongoDB(使用ODM)，而库存信息存储在MySQL(使用ORM)：

// MongoDB中的Product文档
#[ODM\Document]
class Product
{
    #[ODM\Id]
    private $id;
    
    #[ODM\Field(type: Type::STRING)]
    private $name;
    
    #[Gedmo\ReferenceMany(type: 'entity', class: Entity\StockItem::class, mappedBy: 'product')]
    private $stockItems;
    
    // 其他方法和属性...
}

// MySQL中的StockItem实体
#[ORM\Entity]
class StockItem
{
    #[ORM\Id]
    #[ORM\Column(type: Types::INTEGER)]
    #[ORM\GeneratedValue(strategy: 'IDENTITY')]
    private $id;
    
    #[ORM\Column]
    private $name;
    
    #[Gedmo\ReferenceOne(type: 'document', class: Document\Product::class, inversedBy: 'stockItems', identifier: 'productId')]
    private $product;
    
    #[ORM\Column(type: Types::STRING)]
    private $productId;
    
    // 其他方法和属性...
}