Laravel 带额外字段的多对多多态关联的查询、更新与删除实现

完全可以通过纯Eloquent实现全部3个需求，不需要引入DB门面、手写原生join查询。核心是利用Eloquent多对多多态关联原生支持的中间表自定义字段能力，仅需修正关联定义的配置，即可覆盖所有业务场景。

第一步：修正关联定义，解决预加载取不到中间表字段的问题 #

你目前能通过attach方法正常写入left/top字段，说明关联本身的多态映射配置是正确的。查询拿不到这两个字段的核心原因是：Eloquent默认仅会带出中间表的关联主键类字段（content_id、contentable_id、contentable_type），自定义的非主键字段必须通过withPivot方法显式声明，才会在关联查询、预加载时被取出。

关联定义示例（在对应模型中修改） #

1. BookPage 模型

public function contents()
{
    return $this->morphToMany(Content::class, 'contentable', 'contentable')
        ->withPivot('left', 'top'); // 显式声明需要取出的中间表自定义字段
}

2. Post 模型
   逻辑和BookPage完全一致，复用相同的多态关联规则即可：

public function contents()
{
    return $this->morphToMany(Content::class, 'contentable', 'contentable')
        ->withPivot('left', 'top');
}

完成上述配置后，你原有的预加载查询代码不需要做任何改动：

BookPage::where('id', $id)->with('contents')->first();

返回的每个content实例会自动附带pivot属性，属性值里就包含了对应关联的left/top坐标，以及所有关联主键字段。

如果需要把left/top从嵌套的pivot结构展平到content的顶级返回结构，可以在Content模型中补充两个访问器：

// Content 模型
public function getLeftAttribute()
{
    return $this->pivot?->left;
}

public function getTopAttribute()
{
    return $this->pivot?->top;
}

配置后JSON返回结构会变成你预期的扁平化格式，不再嵌套pivot层级。

第二步：实现「更新内容同时同步更新关联坐标」的需求 #

Eloquent多对多关联原生提供了中间表更新能力，两种常用实现方式：

1. 分步更新（内容和坐标分开操作）

// 先更新Content模型本身的业务字段
$content->update([
    'detail' => '更新后的内容描述',
    'url' => 'new-audio-file.mp3'
]);
// 再更新当前BookPage与Content的关联中间表的坐标
$bookPage->contents()->updateExistingPivot($content->id, [
    'left' => '150px',
    'top' => '90px'
]);

2. 单步关联更新
   通过关联的save方法，直接在操作关联的同时完成内容字段更新和中间表字段写入：

// 给Content实例赋值新的业务字段
$content->detail = '更新后的内容描述';
$content->url = 'new-audio-file.mp3';
// save方法第二个参数直接传入需要写入中间表的坐标值
$bookPage->contents()->save($content, [
    'left' => '150px',
    'top' => '90px'
]);

如果需要批量同步关联关系，使用sync方法时也可以直接在关联数组中传入坐标值，Eloquent会自动写入中间表对应字段：

$bookPage->contents()->sync([
    $contentId1 => ['left' => '20px', 'top' => '30px'],
    $contentId2 => ['left' => '200px', 'top' => '150px']
]);

第三步：实现「仅删除关联、不删除内容本身」的需求 #

直接使用Eloquent多对多关联自带的detach方法即可，该方法仅会删除中间表contentable中的对应关联行，不会修改contents主表的任何数据：

// 解除指定BookPage和指定Content的关联
$bookPage->contents()->detach($content->id);

// 解除当前BookPage下的所有Content关联（不传参数即可）
$bookPage->contents()->detach();

注意事项

• 所有关联的withPivot声明必须和你实际查询的关联方法绑定，不能仅在反向关联（Content侧的morphedByMany方法）中声明，否则从BookPage/Post侧查询关联时依然取不到自定义字段。
• 不要将left/top字段存储在Content主表中，因为同一个Content可能关联多个BookPage或Post，每个场景下的定位坐标是独立的，存储在中间表才是符合多对多多态设计的正确结构。
• 如果中间表没有配置时间戳，不需要额外调用withTimestamps()方法，保持关联定义精简即可。

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