<?php namespace App\Models; use Illuminate\Database\Eloquent\Model; /** * Class User * @package App\Models * @mixin \Eloquent */ class User extends Model { /** * 用户角色 */ public function roles() { return $this->belongsToMany('App\Models\Role'); } }
注：正如我们上面提到的，如果中间表不是role_user，那么需要将中间表作为第二个参数传入belongsToMany方法，如果中间表中的字段不是user_id和role_id，这里我们姑且将其命名为$user_id和$role_id，那么需要将$user_id作为第三个参数传入该方法，$role_id作为第四个参数传入该方法，如果关联方法名不是roles还可以将对应的关联方法名作为第五个参数传入该方法。
接下来我们在控制器中编写测试代码：
<?php $user = User::find(1); $roles = $user->roles; echo '用户'.$user->name.'所拥有的角色：'; foreach($roles as $role) echo $role->name.' '; //对应输出为：用户admin所拥有的角色：司令 军长 团战
当然，和所有其它关联关系类型一样，你可以调用roles 方法来添加条件约束到关联查询上：
User::find(1)->roles()->orderBy('name')->get();
正如前面所提到的，为了确定关联关系连接表的表名，Eloquent 以字母顺序连接两个关联模型的名字。不过，你可以重写这种约定 —— 通过传递第二个参数到 belongsToMany 方法：
return $this->belongsToMany('App\Models\Role', 'user_roles');
除了自定义连接表的表名，你还可以通过传递额外参数到 belongsToMany 方法来自定义该表中字段的列名。第三个参数是你定义关联关系模型的外键名称，第四个参数你要连接到的模型的外键名称：
return $this->belongsToMany('App\Models\Role', 'user_roles', 'user_id', 'role_id');
定义相对的关联关系
要定义与多对多关联相对的关联关系，只需在关联模型中调用一下 belongsToMany 方法即可。我们在 Role 模型中定义 users 方法：
<?php namespace App\Models; use Illuminate\Database\Eloquent\Model; /** * Class Role * @package App\Models * @mixin \Eloquent */ class Role extends Model { /** * 角色用户 */ public function users() { return $this->belongsToMany('App\Models\User'); } }
正如你所看到的，定义的关联关系和与其对应的User 中定义的一模一样，只是前者引用 App\Models\Role，后者引用App\Models\User，由于我们再次使用了 belongsToMany 方法，所有的常用表和键自定义选项在定义与多对多相对的关联关系时都是可用的。
测试代码如下：
$role = Role::find(2); $users = $role->users; echo '角色#'.$role->name.'下面的用户：'; foreach ($users as $user) echo $user->name.' ';//对应输出为：角色#司令下面的用户：admin fantasy baidu
正如你看到的，处理多对多关联要求一个中间表。Eloquent 提供了一些有用的方法来与这个中间表进行交互，例如，我们假设 User 对象有很多与之关联的 Role 对象，访问这些关联关系之后，我们可以使用这些模型上的pivot 属性访问中间表字段：
$roles = User::find(1)->roles; foreach ($roles as $role) echo $role->pivot->role_id.'<br>';//对应输出为:2 3 5
注意我们获取到的每一个 Role 模型都被自动赋上了 pivot 属性。该属性包含一个代表中间表的模型，并且可以像其它 Eloquent 模型一样使用。
默认情况下，只有模型主键才能用在 pivot 对象上，如果你的 pivot 表包含额外的属性，必须在定义关联关系时进行指定：
return $this->belongsToMany('App\Models\Role')->withPivot('column1', 'column2');
比如我们修改role_user表增加一个字段 username 数据如下：
修改模型User：
<?php namespace App\Models; use Illuminate\Database\Eloquent\Model; /** * Class User * @package App\Models * @mixin \Eloquent */ class User extends Model { /** * 用户角色 */ public function roles() { //return $this->belongsToMany('App\Models\Role'); return $this->belongsToMany('App\Models\Role')->withPivot('username'); } }
测试代码如下：
$user = User::find(1); foreach ($user->roles as $role) echo $role->pivot->username;//对应输出为：马特马特2马特3
如果你想要你的 pivot 表自动包含created_at 和 updated_at 时间戳，在关联关系定义时使用 withTimestamps 方法：
return $this->belongsToMany('App\Models\Role')->withTimestamps();
通过中间表字段过滤关联关系
你还可以在定义关联关系的时候使用 wherePivot 和 wherePivotIn 方法过滤belongsToMany 返回的结果集：