如何使用Laravel Eloquent实现Poly-polymorphic多态关联

你这个场景属于双向多对多多态关联，Eloquent 原生就支持，不需要引入第三方扩展，按下面的步骤配置即可保留全部ORM特性：

数据库结构 #

你现有的数据库设计不需要调整，核心分两类表：

• 业务表：所有需要参与提及关联的模型对应表，比如posts（文章）、comments（评论）、organizations（组织机构）等，按原有设计建表即可，不需要加额外字段。
• 关联中间表：表名建议取mentions，核心字段如下：
  • id 主键
  • mentioner_id int类型，存储发起提及的主体ID
  • mentioner_type varchar类型，存储发起提及的主体模型类名
  • mentionable_id int类型，存储被提及的对象ID
  • mentionable_type varchar类型，存储被提及的对象模型类名
  • 可选扩展字段：created_at（提及时间）、position（提及位置标记）等自定义业务字段

通用关联逻辑封装 #

所有模型的提及关联逻辑完全一致，直接封装成Trait复用，避免每个模型重复写代码：

<?php

namespace App\Models\Concerns;

use Illuminate\Database\Eloquent\Relations\MorphToMany;

trait HasMentions
{
    /**
     * 获取当前模型主动提及的所有对象
     */
    public function mentions(): MorphToMany
    {
        return $this->morphToMany(
            self::class,
            'mentioner',
            'mentions',
            'mentioner_id',
            'mentionable_id'
        )->withPivot(['created_at']); // 有额外中间表字段在这里加
    }

    /**
     * 获取所有提及了当前模型的对象
     */
    public function mentionedBy(): MorphToMany
    {
        return $this->morphedByMany(
            self::class,
            'mentionable',
            'mentions',
            'mentionable_id',
            'mentioner_id'
        )->withPivot(['created_at']); // 有额外中间表字段在这里加
    }
}

模型引入 #

所有需要支持提及功能的模型，直接引入封装好的Trait即可，不需要写额外关联代码，以Post模型为例：

<?php

namespace App\Models;

use App\Models\Concerns\HasMentions;
use Illuminate\Database\Eloquent\Model;

class Post extends Model
{
    use HasMentions;

    // 模型原有业务代码
}

Comment、Organization等其他需要参与关联的模型，直接同样use HasMentions即可。

常规使用示例 #

• 给指定文章添加提及对象：

$post = Post::find(1);
// 单个添加
$post->mentions()->attach(Comment::find(5));
$post->mentions()->attach(Organization::find(2));
// 批量添加
$post->mentions()->saveMany([
    Comment::find(6),
    Post::find(3)
]);

• 查询某篇文章提及的所有内容：

$post = Post::with('mentions')->find(1); // 支持预加载，避免N+1问题
$allMentionedItems = $post->mentions;
// 返回的集合会自动按type字段映射对应模型实例，不需要手动处理类型
foreach ($allMentionedItems as $item) {
    if ($item instanceof Post) {
        // 处理被提及的文章逻辑
    }
    if ($item instanceof Comment) {
        // 处理被提及的评论逻辑
    }
}

• 反向查询哪些内容提及了指定对象：

$org = Organization::with('mentionedBy')->find(3);
$allMentioners = $org->mentionedBy;
// 返回的集合包含所有提及该机构的Post、Comment等模型实例

• 支持所有Eloquent常规关联操作：条件查询、解绑、同步等，和普通多对多关联用法完全一致。

注意事项 #

• 关联定义里的前缀参数不要写反：主动提及关联mentions()对应中间表前缀是mentioner，反向被提及关联mentionedBy()对应中间表前缀是mentionable，写反会导致关联ID匹配错误。
• 不需要为mentions中间表创建单独的模型，所有关联操作通过业务模型的关联方法完成即可。

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