Laravel如何在用户列表接口中关联返回role_name字段

分两步实现即可：

• 配置模型关联
  打开app/Models/User.php文件，在User类中添加与Role模型的关联方法：

public function role()
{
    return $this->belongsTo(Role::class);
}

现有表结构完全符合Laravel关联的默认约定：users.role_id作为外键关联roles.id，不需要额外配置关联参数，注意提前引入Role模型的命名空间即可。

• 调整控制器查询与返回逻辑
  原代码未关联角色表，也未做字段名映射，修改后的控制器代码如下：

public function getUserList(): JsonResponse {
    $users = User::with('role')
        ->get()
        ->map(function ($user) {
            return [
                'user_id' => $user->id,
                'user_name' => $user->name,
                'role_name' => $user->role?->name
            ];
        });

    return response()->json($users);
}

代码说明：

1. with('role')是预加载关联逻辑，会提前批量查询所有用户对应的角色数据，避免循环单条查询产生的N+1性能问题
2. 通过map方法直接把返回字段对齐接口要求的三个字段，不会返回多余的表结构字段
3. 空安全操作符?->兼容用户未绑定角色的场景，这种情况role_name会返回null，不会抛出关联不存在的错误

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