Doctrine 当前版本（截至2022年9月稳定版）不支持 PHP 8 属性的继承：即使父类声明了 #[Entity]、#[Column] 等 Doctrine 属性，子类也必须显式重复声明，否则会抛出异常或被忽略。
doctrine 当前版本（截至2022年9月稳定版）不支持 php 8 属性的继承：即使父类声明了 `#[entity]`、`#[column]` 等 doctrine 属性，子类也必须显式重复声明，否则会抛出异常或被忽略。
在使用 Doctrine ORM 与 PHP 8+ 的 Attributes（如 #[Entity]、#[Table]、#[Column]）定义实体时，一个常见误区是认为属性可像传统类继承一样“自动传递”——例如将通用字段（如 createdAt、updatedAt）和元数据（如 #[Entity]）提取到抽象基类中，再由具体实体继承。但 Doctrine 并不支持这种行为。
❌ 错误示例：期望属性继承
<?php
use Doctrine\ORM\Mapping as ORM;
#[ORM\MappedSuperclass]
abstract class TimestampedEntity
{
#[ORM\Column(type: 'datetime_immutable')]
protected \DateTimeImmutable $createdAt;
#[ORM\Column(type: 'datetime_immutable')]
protected \DateTimeImmutable $updatedAt;
}
#[ORM\Entity]
class User extends TimestampedEntity // ❌ 缺少 #[Entity]！且 createdAt/updatedAt 不会被识别
{
#[ORM\Id]
#[ORM\GeneratedValue]
#[ORM\Column(type: 'integer')]
private int $id;
#[ORM\Column(type: 'string', length: 255)]
private string $name;
}上述代码会导致 Doctrine 报错（如 MappingException: Class "User" is not a valid entity or mapped super class），因为：
-
#[Entity]未在User类上显式声明（即使父类有#[MappedSuperclass]，也不等价于子类自动获得#[Entity]）； -
#[Column]等字段属性不会从父类继承到子类，Doctrine 仅扫描目标类自身声明的 Attributes，不向上遍历类继承链。
✅ 正确做法：显式声明 + 合理复用
若需共享字段逻辑，仍应使用 #[MappedSuperclass]（配合 Attributes），但需确保：
- 基类自身标记为
#[MappedSuperclass]（非#[Entity]）； - 所有具体实体类独立且完整地声明自身所需的 Attributes；
- 共享字段保留在基类中，但 Doctrine 仅在该基类被实际映射时才解析其 Attributes（即：基类不作为实体使用，仅作为模板）。
<?php
use Doctrine\ORM\Mapping as ORM;
#[ORM\MappedSuperclass]
abstract class TimestampedEntity
{
#[ORM\Column(type: 'datetime_immutable')]
protected \DateTimeImmutable $createdAt;
#[ORM\Column(type: 'datetime_immutable')]
protected \DateTimeImmutable $updatedAt;
}
#[ORM\Entity] // ✅ 必须显式声明
#[ORM\Table(name: 'users')]
class User extends TimestampedEntity
{
#[ORM\Id]
#[ORM\GeneratedValue]
#[ORM\Column(type: 'integer')]
private int $id;
#[ORM\Column(type: 'string', length: 255)]
private string $name;
// createdAt / updatedAt 自动继承字段定义（因基类是 MappedSuperclass）
}✅ 注意：
#[MappedSuperclass]是 Doctrine 特定语义，它允许基类定义可复用的字段和生命周期回调，但不生成对应数据库表；而#[Entity]必须出现在最终映射的实体类上。
? 补充说明：为什么 Doctrine 不支持属性继承？
Doctrine 团队尚未实现属性继承，主要原因包括：
-
设计明确性优先：避免歧义（例如，子类是否应覆盖父类
#[Table]？如何合并#[Index]？）； - 性能考量：反射遍历继承链会增加元数据解析开销；
-
实现复杂度：Attributes 本身无内置继承语义（PHP 语言层不提供
@Inherited类似机制），需 Doctrine 自行实现深度查找与合并策略； - 演进节奏：Attributes 支持在 Doctrine 2.9+ 中引入，属较新特性，核心继承模型仍以注解时代逻辑为基础。
✅ 最佳实践建议
- ✅ 使用
#[MappedSuperclass]+ Attributes 实现字段复用（推荐）； - ✅ 永远在具体实体类上显式声明
#[Entity]、#[Table]、#[Id]等关键元数据； - ❌ 避免依赖 PHP 层级的“属性继承”幻想；
- ? 若需高度抽象，可结合 PHP Traits 封装通用方法（如
touchTimestamps()），但字段映射仍需 Attributes 显式声明。
总之，Doctrine Attributes 是强大而清晰的映射语法，但其作用域严格限定于声明它的类本身——这是确定性与可维护性的权衡，而非限制。理解这一点，能帮你构建更健壮、可预期的实体架构。
