如何使用 XML 或 YAML 而非注解映射来定义 Doctrine mappedSuperclass

Question

以下脚本来自https://www.doctrine-project.org/projects/doctrine-orm/en/2.6/reference/inheritance-mapping.html#mapped-superclasses，仅更改为包含第二个子类。据我了解，MappedSuperclassBase 不能单独存在，必须由一个且只有一个子类扩展（即EntitySubClassOne 或EntitySubClassTwo），并且与 SQL 的超类型/子类型概念相同。同意吗？

如何使用 YAML 或 XML 而非注解映射来定义超级/子类型？

<?php
/** @MappedSuperclass */
class MappedSuperclassBase
{
    /** @Column(type="integer") */
    protected $mapped1;
    /** @Column(type="string") */
    protected $mapped2;
    /**
     * @OneToOne(targetEntity="MappedSuperclassRelated1")
     * @JoinColumn(name="related1_id", referencedColumnName="id")
     */
    protected $mappedRelated1;

    // ... more fields and methods
}

/** @Entity */
class EntitySubClassOne extends MappedSuperclassBase
{
    /** @Id @Column(type="integer") */
    private $id;
    /** @Column(type="string") */
    private $name;

    // ... more fields and methods
}

/** @Entity */
class EntitySubClassTwo extends MappedSuperclassBase
{
    /** @Id @Column(type="integer") */
    private $id;
    /** @Column(type="string") */
    private $name;

    // ... more fields and methods
}

Answer 1

根据我们的 cmets，我想我看到了您的困惑。因为the docs 在同一页面上同时处理“MappedSuperclass”和“Discriminator”，所以我认为您已经混淆了它们的用途。希望这可以帮助您：

• MappedSuperclass 以可重用的方式提供属性/默认值，但它本身永远不能成为实体。这相当于 PHP 的 abstract 类（不能自行实例化）
• 鉴别器提供“扩展”实体的能力，使其成为另一个实体。例如，拥有Person 实体会为您提供 1 个实体。此实体可以扩展，例如通过Worker 和Manager。

MappedSuperclass 的一个很好的用例是AbstractEntity。每个实体都需要一个 ID，一个唯一的标识符。它还为您提供了在 Listeners 等中检查的常见内容。所以，继续创建：

/**
 * @ORM\MappedSuperclass
 */
abstract class AbstractEntity
{
    /**
     * @var int
     * @ORM\Id
     * @ORM\Column(name="id", type="integer", options={"unsigned":true})
     * @ORM\GeneratedValue(strategy="IDENTITY")
     */
    protected $id;
  
    // getter / setter
}

看看abstract 和MappedSuperclass 是如何声明的？

这是因为（abstract class 和 MappedSuperclass）都不能自己实例化。你不能做$entity = new AbstractEntity()，因为它是一个abstract PHP 类。 Doctrine 也不会为AbstractEntity 创建单独的表。

接下来，创建一个Person：

/**
 * @ORM\Entity
 * @ORM\Table(name="persons")
 *
 * @InheritanceType("JOINED")
 * @DiscriminatorColumn(name="discr", type="string")
 */
class Person extends AbstractEntity
{
    /**
     * @var string
     * @ORM\Column(name="name", type="string", length=255, nullable=false)
     */
    protected $name;

    // getter / setter
}

上面的Person，Entity是通过JOINED继承类型为Class Table Inheritance设置的。这意味着，在数据库级别，表 persons 将与其他实体添加的任何列分开，扩展 Person。

注意我没有声明DiscriminatorMap。以下来自文档，由我以粗体突出显示：

注意事项：

• @InheritanceType、@DiscriminatorColumn 和 @DiscriminatorMap 必须在作为映射实体层次结构一部分的最顶层类中指定。
• @DiscriminatorMap 指定鉴别器列的哪些值将行标识为哪种类型。在上面的例子中，“person”值将一行标识为 Person 类型，“employee”将一行标识为 Employee 类型。
• 如果类与应用了鉴别器映射的实体类包含在同一命名空间中，则鉴别器映射中的类的名称不需要完全限定。
• 如果没有提供鉴别图，则自动生成图。自动生成的鉴别器映射包含每个类的小写短名称作为键。

现在，让我们创建一个Worker：

/**
 * @ORM\Entity
 * @ORM\Table(name="workers")
 */
class Worker extends Person
{
    /**
     * @var int
     * @ORM\Column(name="worker_id", type="integer", length=11, nullable=false)
     */
    protected $workerId;

    // getter / setter
}

所以，现在我们有了：

• MappedSuperclass：AbstractEntity - 不是独立实体
• 受歧视：Person - 是独立实体
• “正常”：Worker - 扩展 Person

注意事项：

• MappedSuperclass 无法实例化。因此：您不能创建到它的链接/关系。媲美PHP的abstract class
• 可识别实体是一个独立的实体，可用作普通实体。您可以毫无问题地与它建立关系
• 扩展可识别实体的实体是两者的实例。在上面的代码中，这两个都是真的：$worker instanceof Worker 和$worker instanceof Person，因为Worker 扩展了Person。但是，$person instanceof Worker 将是 false！

$workerId = $person->getWorkerId() // generates "method does not exist" fatal

$workerId = $worker->getWorkerId() // generates integer value

---

希望能够为您解决问题。如果没有，请随时询问。