如何在多个实体中复用同一实体字段并简化查询？

一、字段复用的两种高效方案 #

1. 使用Trait复用字段定义 #

Trait是PHP中实现轻量代码复用的理想方案，适合单一或少量字段跨实体复用，不会影响实体的继承关系。

创建Trait文件：

<?php
namespace App\Entity\Traits;

use Doctrine\ORM\Mapping as ORM;

trait RelatedEntityTrait
{
    #[ORM\Column(length: 255)]
    private ?string $relatedEntity = null;

    // 统一添加getter/setter，避免每个实体重复编写
    public function getRelatedEntity(): ?string
    {
        return $this->relatedEntity;
    }

    public function setRelatedEntity(?string $relatedEntity): self
    {
        $this->relatedEntity = $relatedEntity;
        return $this;
    }
}

在实体中直接引入：

<?php
namespace App\Entity;

use App\Entity\Traits\RelatedEntityTrait;
use Doctrine\ORM\Mapping as ORM;

#[ORM\Entity]
class User
{
    use RelatedEntityTrait;

    // 其他实体字段
    #[ORM\Id]
    #[ORM\GeneratedValue]
    #[ORM\Column(type: 'integer')]
    private ?int $id = null;
}

<?php
namespace App\Entity;

use App\Entity\Traits\RelatedEntityTrait;
use Doctrine\ORM\Mapping as ORM;

#[ORM\Entity]
class User2
{
    use RelatedEntityTrait;

    // 其他实体字段
    #[ORM\Id]
    #[ORM\GeneratedValue]
    #[ORM\Column(type: 'integer')]
    private ?int $id = null;
}

2. 使用Mapped Superclass（映射超类） #

如果多个实体除relatedEntity外还有更多共同字段，可通过抽象超类统一定义，实体继承该类即可共享所有字段逻辑。

创建映射超类：

<?php
namespace App\Entity\Superclass;

use Doctrine\ORM\Mapping as ORM;

#[ORM\MappedSuperclass]
abstract class AbstractRelatedEntity
{
    #[ORM\Column(length: 255)]
    private ?string $relatedEntity = null;

    public function getRelatedEntity(): ?string
    {
        return $this->relatedEntity;
    }

    public function setRelatedEntity(?string $relatedEntity): self
    {
        $this->relatedEntity = $relatedEntity;
        return $this;
    }
}

实体继承使用：

<?php
namespace App\Entity;

use App\Entity\Superclass\AbstractRelatedEntity;
use Doctrine\ORM\Mapping as ORM;

#[ORM\Entity]
class User extends AbstractRelatedEntity
{
    #[ORM\Id]
    #[ORM\GeneratedValue]
    #[ORM\Column(type: 'integer')]
    private ?int $id = null;
}

二、关联查询的优化方案（解决父字段映射问题） #

你提到使用OneToOne关联时会自动新增用户，这大概率是因为设置了cascade={"persist"}导致的。推荐用单向ManyToOne关联替代字符串存储，既简化查询又避免不必要的实体创建：

1. 调整实体关联逻辑 #

假设relatedEntity实际指向某个主实体（比如MainEntity），User和其他实体都关联到该主实体：

先定义主实体：

<?php
namespace App\Entity;

use Doctrine\ORM\Mapping as ORM;

#[ORM\Entity]
class MainEntity
{
    #[ORM\Id]
    #[ORM\GeneratedValue]
    #[ORM\Column(type: 'integer')]
    private ?int $id = null;

    #[ORM\Column(length: 255)]
    private ?string $name = null;

    // 对应的getter/setter
}

然后在User及其他实体中配置ManyToOne关联，不设置级联persist：

<?php
namespace App\Entity;

use Doctrine\ORM\Mapping as ORM;

#[ORM\Entity]
class User
{
    #[ORM\Id]
    #[ORM\GeneratedValue]
    #[ORM\Column(type: 'integer')]
    private ?int $id = null;

    #[ORM\ManyToOne(targetEntity: MainEntity::class)]
    #[ORM\JoinColumn(name: 'related_entity_id', referencedColumnName: 'id', nullable: true)]
    private ?MainEntity $relatedEntity = null;

    // 对应的getter/setter
}

<?php
namespace App\Entity;

use Doctrine\ORM\Mapping as ORM;

#[ORM\Entity]
class User2
{
    #[ORM\Id]
    #[ORM\GeneratedValue]
    #[ORM\Column(type: 'integer')]
    private ?int $id = null;

    #[ORM\ManyToOne(targetEntity: MainEntity::class)]
    #[ORM\JoinColumn(name: 'related_entity_id', referencedColumnName: 'id', nullable: true)]
    private ?MainEntity $relatedEntity = null;

    // 对应的getter/setter
}

2. 简化查询示例 #

通过关联映射，可直接在DQL或QueryBuilder中进行关联查询，无需手动拼接字符串ID：

// 查询所有关联到同一MainEntity的User和User2
$qb = $entityManager->createQueryBuilder();
$qb->select('u', 'u2')
   ->from(User::class, 'u')
   ->join(User2::class, 'u2', 'WITH', 'u.relatedEntity = u2.relatedEntity')
   ->where('u.relatedEntity = :mainEntity')
   ->setParameter('mainEntity', $mainEntity);
$result = $qb->getQuery()->getResult();

3. 避免自动新增实体的关键 #

不要在关联注解中添加cascade={"persist"}，这样创建User2并设置relatedEntity时，Doctrine只会关联已存在的MainEntity，不会自动创建新的实体实例。

内容的提问来源于stack exchange，提问作者4michal