学说：具有复合键的实体之间的 ManyToX 关系

Question

我有三个实体，我们称它们为 Site、Category 和 Tag。在这种情况下，Category 和 Tag 具有从 Site 实体生成的复合 ID 和不唯一的外部 ID（site 和 id 一起是唯一的）。 Category 与 Tag 具有多对多关系。 （尽管我的问题也可以通过多对一关系重现。）

Site 实体：

/**
 * @ORM\Entity
 */
class Site
{
    /**
     * @ORM\Id
     * @ORM\GeneratedValue
     * @ORM\Column(type="integer")
     */
    private $id;

    /**
     * @ORM\Column(type="string")
     */
    private $name;
}

Category 实体：

/**
 * @ORM\Entity
 */
class Category extends AbstractSiteAwareEntity
{
    /**
     * @ORM\Column(type="string")
     */
    private $name;

    /**
     * @ORM\ManyToMany(targetEntity="Tag")
     */
    private $tags;
}

Tag 实体：

/**
 * @ORM\Entity
 */
class Tag extends AbstractSiteAwareEntity
{
    /**
     * @ORM\Column(type="string")
     */
    private $name;
}

最后两个实体继承自 AbstractSiteAwareEntity 类，它定义了复合索引：

abstract class AbstractSiteAwareEntity
{
    /**
     * @ORM\Id
     * @ORM\ManyToOne(targetEntity="Site")
     */
    public $site;

    /**
     * @ORM\Id
     * @ORM\Column(type="integer")
     */
    public $id;
}

作为 ManyToOne 关系的示例，让我们想象一个 Post 实体，它有一个自增 ID 和对 Category 的引用：

/**
 * @ORM\Entity
 */
class Post
{
    /**
     * @ORM\Id
     * @ORM\GeneratedValue
     * @ORM\Column(type="integer")
     */
    public $id;

    /**
     * @ORM\ManyToOne(targetEntity="Category")
     */
    private $category;

    /**
     * @ORM\Column(type="string")
     */
    private $title;

    /**
     * @ORM\Column(type="string")
     */
    private $content;
}

使用bin/console doctrine:schema:update --dump-sql --force --complete 更新架构时，出现以下异常：

执行 'ALTER TABLE category_tag ADD 时发生异常 约束 FK_D80F351812469DE2 外键（category_id）参考 类别 (id) ON DELETE CASCADE'：

SQLSTATE[HY000]：一般错误：1005 无法创建表 xxxxxxx.#sql-3cf_14b6 (errno: 150 "外键约束为 格式不正确")

我不确定可能出了什么问题……我的实体定义是否有错误？或者这是一个 Doctrine 错误？

注意：我在 Symfony 3.4 上使用教义/dbal 2.6.3。

Answer 1

您必须在注释中定义加入的列才能使其工作：

对于多对一关系：

/**
 * @ORM\ManyToOne(targetEntity="Tag")
 * @ORM\JoinColumns({
 *     @ORM\JoinColumn(name="tag_site_id", referencedColumnName="site_id"),
 *     @ORM\JoinColumn(name="tag_id", referencedColumnName="id")
 * })
 **/
protected $tag;

对于多对多关系：

/**
 * @ORM\ManyToMany(targetEntity="Tag")
 * @ORM\JoinTable(name="category_tags",
 *      joinColumns={
 *     @ORM\JoinColumn(name="category_site_id", referencedColumnName="site_id"),
 *     @ORM\JoinColumn(name="category_id", referencedColumnName="id")
 *     },
 *      inverseJoinColumns={
 *     @ORM\JoinColumn(name="tag_site_id", referencedColumnName="site_id"),
 *     @ORM\JoinColumn(name="tag_id", referencedColumnName="id")
 *     }
 *      )
 **/
 protected $tags;

工作原理：创建 2 列作为 FOREIGN KEY，REFERENCES 复合外键。

注意：在“@ORM\JoinColumn”设置中：

• “referencedColumnName”设置是相关表的id列名，所以应该已经存在了。

• “name”是存储外键并被创建的列名，在 ManyToOne 的情况下，它不应与实体的任何列冲突。

joinColumns 定义的顺序很重要。复合外键应以引用表中具有索引的列开头。在这种情况下，"@ORM\JoinColumn" 到 "site_id" 应该是first。 Reference

Answer 2

基于Jannis’ answer，我终于找到了解决方案。解决方案由两部分组成：

第一部分有点奇怪：显然，Doctrine 在AbstractSiteEntity 中定义的复合主键中的$site 引用之前需要$id。这听起来很奇怪，但这绝对是真的，因为我尝试了几次来回交换它们，但出于某种原因，只有这个顺序有效。

abstract class AbstractSiteAwareEntity
{
    // $id must come before $site

    /**
     * @ORM\Id
     * @ORM\Column(type="integer")
     */
    public $id;

    /**
     * @ORM\Id
     * @ORM\ManyToOne(targetEntity="Site")
     */
    public $site;
}

对于多对多关系，JoinTable 中的索引必须明确声明，因为 Doctrine 无法自行创建复合外键。我使用了 Jannis 的建议，并做了一些修改（实际上不需要列名）：

/**
 * @ORM\ManyToMany(targetEntity="Tag")
 * @ORM\JoinTable(
 *  joinColumns={
 *      @ORM\JoinColumn(referencedColumnName="id"),
 *      @ORM\JoinColumn(referencedColumnName="site_id")
 *  },
 *  inverseJoinColumns={
 *      @ORM\JoinColumn(referencedColumnName="id"),
 *      @ORM\JoinColumn(referencedColumnName="site_id")
 *  }
 * )
*/
private $tags;

Answer 3

您不能对关系使用复合 PrK 键。
相反，定义一个 ID 和一个复合 UNI 键（或者在这种情况下只是 UNI 键）

复合 UNI 密钥示例

/**
 * SiteAware
 *
 * @ORM\Table(name="site_aware",
 *     uniqueConstraints={@ORM\UniqueConstraint(columns={"site_id", "random_entity_id"})})
 * @UniqueEntity(fields={"site", "randomEntity"}, message="This pair combination is already listed")
 */
abstract class AbstractSiteAwareEntity
{
    /**
     * @ORM\Id
     * @ORM\Column(type="integer")
     */
    public $id;
    /**
     * @ORM\ManyToOne(targetEntity="Site")
     */
    public $site;
    /**
     * @ORM\ManyToOne(targetEntity="RandomEntity")
     */
    public $randomEntity;
}

简单的唯一键

abstract class AbstractSiteAwareEntity
{
    /**
     * @ORM\Id
     * @ORM\Column(type="integer")
     */
    public $id;
    /**
     * @ORM\ManyToOne(targetEntity="Site")
     * @ORM\JoinColumn(unique=true)
     */
    public $site;
}