如何用Doctrine的#[Embedded]属性实现User嵌入Address对象集合？

你之前的写法存在问题：Doctrine的#[Embedded]注解本身不支持直接声明数组形式的嵌入对象，直接在类名后加[]会导致Doctrine无法正确实例化Address对象，最终返回的是原始二维数组而非Address实例集合。

下面提供两种可行的实现方案：

方案一：将Address作为独立实体，使用一对多关联 #

如果Address需要独立维护或者具备自身的标识属性，推荐把它定义为实体，然后在User中通过#[OneToMany]建立关联：

<?php
use Doctrine\ORM\Mapping\Entity;
use Doctrine\ORM\Mapping\Id;
use Doctrine\ORM\Mapping\GeneratedValue;
use Doctrine\ORM\Mapping\ManyToOne;
use Doctrine\ORM\Mapping\OneToMany;
use Doctrine\Common\Collections\ArrayCollection;
use Doctrine\Common\Collections\Collection;

#[Entity]
class Address
{
    #[Id, GeneratedValue]
    private int $id;
    
    private string $name;
    
    #[ManyToOne(targetEntity: User::class, inversedBy: 'addresses')]
    private User $user;

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

    public function setUser(User $user): void
    {
        $this->user = $user;
    }

    public function getName(): string
    {
        return $this->name;
    }
}

#[Entity]
class User
{
    #[Id, GeneratedValue]
    private int $id;
    
    /** @var Collection<int, Address> */
    #[OneToMany(targetEntity: Address::class, mappedBy: 'user', cascade: ['persist', 'remove'], orphanRemoval: true)]
    private Collection $addresses;
    
    public function __construct()
    {
        $this->addresses = new ArrayCollection();
    }
    
    public function addAddress(Address $address): void
    {
        if (!$this->addresses->contains($address)) {
            $address->setUser($this);
            $this->addresses->add($address);
        }
    }
    
    public function removeAddress(Address $address): void
    {
        $this->addresses->removeElement($address);
    }

    /** @return Collection<int, Address> */
    public function getAddresses(): Collection
    {
        return $this->addresses;
    }
}

这种方式是Doctrine处理一对多关联的标准做法，支持完整的ORM操作，比如持久化、查询级联等。

方案二：将Address作为值对象，序列化存储为JSON数组 #

如果Address不需要作为独立实体，仅作为User的附属值对象存在，可以把地址数组序列化为JSON格式存储在数据库字段中，同时在实体类中处理实例的序列化和反序列化：

<?php
use Doctrine\ORM\Mapping\Entity;
use Doctrine\ORM\Mapping\Id;
use Doctrine\ORM\Mapping\GeneratedValue;
use Doctrine\ORM\Mapping\Column;

// 地址值对象
class Address
{
    public function __construct(public string $name) {}
}

#[Entity]
class User
{
    #[Id, GeneratedValue]
    private int $id;
    
    #[Column(type: 'json')]
    private array $addressData = [];
    
    /**
     * 获取Address实例数组
     * @return Address[]
     */
    public function getAddresses(): array
    {
        return array_map(fn($data) => new Address($data['name']), $this->addressData);
    }
    
    public function addAddress(Address $address): void
    {
        $this->addressData[] = ['name' => $address->name];
    }

    // 可选：移除地址的方法
    public function removeAddress(string $addressName): void
    {
        $this->addressData = array_filter($this->addressData, fn($data) => $data['name'] !== $addressName);
    }
}

这种方式更轻量化，适合不需要独立操作Address的场景，但注意无法直接通过Doctrine查询Address的单个属性。

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