Laravel如何实现多对多模型关联？（Eloquent教程）-Laravel-PHP中文网

Laravel如何实现多对多模型关联？（Eloquent教程）

裘德小鎮的故事

发布： 2025-12-21 16:13:15

原创

862人浏览过

Laravel多对多关联需规范命名中间表（如role_user）并定义belongsToMany关系，Eloquent自动处理查询、同步与更新。

laravel如何实现多对多模型关联？（eloquent教程）

在 Laravel 中实现多对多模型关联，核心是定义好中间表（pivot table）和模型中的对应关系方法。Eloquent 会自动处理关联查询、数据同步与更新，无需手写复杂 SQL。

创建中间表迁移

多对多关系必须有一个中间表，命名需遵循 Laravel 规范：按字母顺序拼接两个模型的单数形式（如 role_user，而非 user_role）。中间表通常只包含两个外键字段：

role_id（关联 roles 表）
user_id（关联 users 表）

生成迁移并运行：

php artisan make:migration create_role_user_table

在迁移文件中定义：

Schema::create('role_user', function (Blueprint $table) {
    $table->id();
    $table->foreignId('role_id')->constrained()->onDelete('cascade');
    $table->foreignId('user_id')->constrained()->onDelete('cascade');
    $table->timestamps();

    $table->unique(['role_id', 'user_id']); // 防止重复关联
});

登录后复制

在模型中定义关联方法

两个模型都要声明 belongsToMany 关系，参数顺序和中间表名要一致：

User 模型：

public function roles()
{
    return $this->belongsToMany(Role::class, 'role_user', 'user_id', 'role_id');
}

登录后复制

Role 模型：

Designify

拖入图片便可自动去除背景✨

查看详情

public function users()
{
    return $this->belongsToMany(User::class, 'role_user', 'role_id', 'user_id');
}

登录后复制

如果中间表名和外键名符合 Laravel 默认约定（model1_model2 + model1_id/model2_id），可省略后三个参数：

// User.php（默认约定下可简写）
public function roles()
{
    return $this->belongsToMany(Role::class);
}

登录后复制

常用操作示例

关联建立后，Eloquent 提供多种便捷操作：

获取用户的所有角色：$user->roles（返回 Collection）
判断用户是否有某角色：$user->roles->contains('name', 'admin') 或用 wherePivot 查询中间表字段
添加角色（插入中间表）：$user->roles()->attach($roleId) 或批量 attach([1, 2, 3])
解除角色：$user->roles()->detach($roleId) 或全部清除 detach()
同步角色（先清空再设置）：$user->roles()->sync([1, 5, 8]) —— 常用于表单提交场景

扩展中间表字段（带额外属性）

若中间表有额外字段（如 created_at、assigned_by），可在关联中启用时间戳或自定义字段：

// 在 belongsToMany 后链式调用
return $this->belongsToMany(Role::class)
    ->withTimestamps() // 自动维护 created_at/updated_at
    ->withPivot('assigned_by', 'expires_at'); // 允许访问中间表字段

登录后复制

之后可通过 $user->roles->first()->pivot->assigned_by 获取。

基本上就这些。只要中间表结构规范、模型方法写对，Laravel 就能自动完成关联查询与维护，不复杂但容易忽略命名约定。

以上就是Laravel如何实现多对多模型关联？（Eloquent教程）的详细内容，更多请关注php中文网其它相关文章！