morphedByMany是多态多对多关系中被关联方唯一合法定义方式，必须写在Post、Video等被标记模型中，参数顺序为关联类、中间表、本模型ID字段、目标ID字段、类型字段，缺一不可。
不是「可选的语法糖」，它是多态多对多关系中「被关联方」唯一合法的定义方式。写错位置、漏参数、字段名不匹配，都会导致查询返回空数组、
写不进数据、
拿不到中间表字段。
必须写在「被多态关联的一方」模型里
比如 Post 被 Tag 标记，Video 也被 Tag 标记，那
只能写在
和
模型里，不能写在
模型里。
常见错误现象：
返回空集合，即使数据库里有对应记录
执行
后，
表里
字段为空或写成
原因：Eloquent 把
当作「发起关联方」，会按
逻辑去查
，但实际字段是
和
，SQL 完全对不上。
正确做法：
在
中定义：
在
中同样定义：
五个参数一个都不能少，顺序不能错
不像
那样能靠命名推导字段，所有字段名都得手动传，漏一个就失效。
参数含义（严格按顺序）：
Laravel 13.2.0
PHP中文网提供Laravel 13.2.0版本下载，Laravel框架 是基于 PHP 8.3+ 的高性能框架，官方推荐通过 Composer 安装。它内置 AI SDK、JSON:API Resources 及原生向量搜索，支持属性驱动开发与队列路由，大幅提升开发效率。相比旧版，13.2.0 优化了缓存 TTL 管理与实时通信，无需 Redis 即可横向扩展。作为现代 Web 开发首选，它兼顾安全与极速体验，助您快速构建企业级应用。
下载
：你要关联的目标模型类
：中间表名，注意不是
或
：本模型（如 Post）的 ID 在中间表存哪 —— 必须和迁移里
字段名完全一致
：目标模型（Tag）的 ID 在中间表存哪 —— 通常就是
字段映射过来的字段名
：类型字段名，必须和迁移里定义的
一模一样，大小写敏感
典型陷阱：
把第三个参数写成
（这是
的写法，不适用）
中间表叫
，但只传前四个参数，没传第五个
，结果
读不到附加字段
attach() 和 sync() 前必须确保模型已存在
看似简单，但底层依赖
返回正确的类名。如果
是
或刚
出来还没保存，
会返回空字符串，导致中间表写入
或
错误格式（取决于 Laravel 版本）。
所以：
务必先
或
成功后再调用
不要在未持久化的模型实例上调用
，否则中间表可能残留脏数据
批量操作时，用
预加载，别在循环里反复查
with('tags') 预加载时不会自动过滤 taggable_type
如果你的
表里混着
、
、
的记录，执行
时，Eloquent 会把所有
的 ID 打包进一条 IN 查询，但它**不会加
** —— 这个条件要你手动加，否则可能查出属于 User 的标签。
解决办法只有两种：
确保中间表里只存当前模型类型的记录（推荐，靠业务逻辑或数据库约束保证）
改用显式查询：
这个限制容易被忽略，因为单条
动态属性会自动带类型条件，但预加载不会 —— 底层实现机制不同。
morphedByManyattach()withPivot()morphedByManyPostVideoTagTag::find(1)->posts()$post->tags()->attach(1)taggablestaggable_typeApp\Models\TagTagbelongsToManytag_id = ?taggable_idtaggable_typePost.phppublic function tags() { return $this->morphedByMany(Tag::class, 'taggables', 'taggable_id', 'tag_id', 'taggable_type'); }Video.phppublic function tags() { return $this->morphedByMany(Tag::class, 'taggables', 'taggable_id', 'tag_id', 'taggable_type'); }morphedByManymorphToManyTag::class'taggables''tags''post_tags''taggable_id'$table->unsignedBigInteger('taggable_id')'tag_id'id'taggable_type'$table->string('taggable_type')'post_id'belongsToManymodel_tags'model_type'withPivot()$post->tags()->attach($tagId)$post->getMorphClass()$postnew Postmake()getMorphClass()'''App\Models\Post'$post = Post::find(1)$post->save()attach()sync()Post::whereIn('id', [...])->with('tags')->get()taggablesPostUserVideoPost::with('tags')->get()PostWHERE taggable_type = 'App\Models\Post'Post::with(['tags' => function ($q) { $q->where('taggable_type', Post::class); }])->get()$post->tags