如何在Symfony Doctrine中实现类似Laravel的一对多（多态）关联？

核心实现方案 #

1. 定义通用接口（统一所有者类型） #

创建LogableInterface，让User和Admin实体实现它，统一多态关联的目标类型：

<?php

namespace App\Entity;

interface LogableInterface
{
    public function getLogs(): \Doctrine\Common\Collections\Collection;
    public function addLog(Log $log): self;
    public function removeLog(Log $log): self;
}

2. 配置User和Admin实体的一对多关联 #

在两个所有者实体中添加指向Log的一对多关联，自动维护关联关系：

User实体示例：

<?php

namespace App\Entity;

use Doctrine\Common\Collections\ArrayCollection;
use Doctrine\Common\Collections\Collection;
use Doctrine\ORM\Mapping as ORM;

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

    // 其他业务字段...

    #[ORM\OneToMany(mappedBy: 'logable', targetEntity: Log::class, orphanRemoval: true)]
    private Collection $logs;

    public function __construct()
    {
        $this->logs = new ArrayCollection();
    }

    public function getLogs(): Collection
    {
        return $this->logs;
    }

    public function addLog(Log $log): self
    {
        if (!$this->logs->contains($log)) {
            $this->logs->add($log);
            $log->setLogable($this);
        }
        return $this;
    }

    public function removeLog(Log $log): self
    {
        if ($this->logs->removeElement($log) && $log->getLogable() === $this) {
            $log->setLogable(null);
        }
        return $this;
    }

    // 其他业务方法...
}

Admin实体示例：

结构与User一致，仅需替换类名即可。

3. 配置Log实体的多态关联 #

在Log实体中定义多态关联的核心字段（logable_id和logable_type），通过Doctrine注解实现多态映射：

<?php

namespace App\Entity;

use Doctrine\ORM\Mapping as ORM;

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

    #[ORM\Column(type: 'text')]
    private ?string $content = null;

    // 多态关联存储字段
    #[ORM\Column(type: 'string')]
    private ?string $logableType = null;

    #[ORM\Column(type: 'integer')]
    private ?int $logableId = null;

    // 多态关联映射：关联到LogableInterface，配置鉴别器映射
    #[ORM\ManyToOne(targetEntity: LogableInterface::class, inversedBy: 'logs')]
    #[ORM\JoinColumn(name: 'logable_id', referencedColumnName: 'id', insertable: false, updatable: false)]
    #[ORM\JoinColumn(name: 'logable_type', referencedColumnName: 'discriminator', insertable: false, updatable: false)]
    #[ORM\DiscriminatorColumn(name: 'logable_type', type: 'string')]
    #[ORM\DiscriminatorMap([
        'user' => User::class,
        'admin' => Admin::class,
    ])]
    private ?LogableInterface $logable = null;

    // 自动维护logableType和logableId
    public function setLogable(?LogableInterface $logable): self
    {
        $this->logable = $logable;
        if ($logable) {
            $this->logableType = match(get_class($logable)) {
                User::class => 'user',
                Admin::class => 'admin',
                default => throw new \InvalidArgumentException('不支持的日志所有者类型'),
            };
            $this->logableId = $logable->getId();
        } else {
            $this->logableType = $this->logableId = null;
        }
        return $this;
    }

    // 其他getter和业务方法...
}

使用示例 #

创建日志 #

// 给用户添加日志
$user = $entityManager->find(User::class, 1);
$userLog = new Log();
$userLog->setContent('用户登录系统');
$user->addLog($userLog);

// 给管理员添加日志
$admin = $entityManager->find(Admin::class, 1);
$adminLog = new Log();
$adminLog->setContent('管理员更新了系统配置');
$admin->addLog($adminLog);

$entityManager->persist($userLog);
$entityManager->persist($adminLog);
$entityManager->flush();

查询日志 #

// 获取某个用户的所有日志
$userLogs = $user->getLogs();

// 获取某条日志的所有者（自动返回User或Admin实例）
$log = $entityManager->find(Log::class, 1);
$owner = $log->getLogable();

// 查询所有用户相关的日志
$userLogs = $entityManager->createQuery(
    'SELECT l FROM App\Entity\Log l WHERE l.logableType = :type'
)->setParameter('type', 'user')->getResult();

优化建议 #

• 索引优化：给logable_id和logable_type字段添加联合索引，提升多态查询性能。
• 代码复用：将setLogable中的鉴别器值判断逻辑提取到Trait或单独服务中，避免重复代码。
• 类型安全：通过接口约束所有者实体，确保所有关联实体都实现统一的日志管理方法。
• 软删除支持：若需软删除，可在Log实体中添加deletedAt字段，配合Doctrine Filters实现软删除查询。

内容的提问来源于stack exchange，提问作者Mojtaba Nematpour