Laravel中Horse与Race多对多关联及中间表数据保存问题

第一步：定义模型间的多对多关联 #

首先需要在Cheval和Course模型中正确定义多对多关联，明确指定中间表名称与对应外键：

Cheval模型 #

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class Cheval extends Model
{
    // 关联赛事（多对多）
    public function courses()
    {
        // 参数依次：关联模型、中间表名、当前模型在中间表的外键、关联模型在中间表的外键
        return $this->belongsToMany(Course::class, 'horses_races', 'cheval_id', 'course_id');
    }
}

Course模型 #

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class Course extends Model
{
    // 关联马匹（多对多）
    public function chevaux()
    {
        return $this->belongsToMany(Cheval::class, 'horses_races', 'course_id', 'cheval_id');
    }
}

第二步：保存马匹与赛事的关联数据 #

你之前的错误根源是BelongsToMany的save()方法要求传入模型实例而非数组，以下是两种正确的保存方式：

方式1：使用attach()方法（直接传ID） #

若已知赛事ID，直接调用attach()即可自动在中间表创建关联记录：

// $race为已获取的Course模型实例，或直接传入赛事ID
$cheval->courses()->attach($race->id);

方式2：使用save()方法（传入模型实例） #

若已持有Course模型实例，直接传入save()方法即可：

// $race是已存在的Course模型实例
$cheval->courses()->save($race);

如果需要批量关联多个赛事，可传入ID数组：

// 一次性关联多个赛事
$cheval->courses()->attach([1, 3, 5]);

第三步：查询关联数据 #

查询指定赛事的所有参赛马 #

// 获取赛事并预加载参赛马（避免N+1查询问题）
$course = Course::with('chevaux')->find($courseId);
// 遍历输出参赛马信息
foreach ($course->chevaux as $cheval) {
    echo $cheval->name;
}

查询指定马匹参与的所有赛事 #

// 获取马匹并预加载参与的赛事
$cheval = Cheval::with('courses')->find($chevalId);
// 遍历输出赛事信息
foreach ($cheval->courses as $course) {
    echo $course->name;
}

额外操作补充 #

• 移除单条关联：$cheval->courses()->detach($raceId);
• 同步关联（仅保留指定关联，移除其他）：$cheval->courses()->sync([2,4]);

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