Laravel 9简化实现管理员分配用户角色与路由权限方案咨询

完全可以基于你最初的Laravel 9默认实现改造，不需要重新安装框架或依赖复杂第三方包。以下是仅满足「管理员分配角色+路由权限管控」需求的最简步骤：

步骤1：添加角色相关迁移 #

1.1 创建角色表迁移 #

运行命令生成迁移文件：

php artisan make:migration create_roles_table

在迁移文件中写入：

public function up()
{
    Schema::create('roles', function (Blueprint $table) {
        $table->id();
        $table->string('name')->unique(); // 示例值：'admin', 'user'
        $table->string('display_name')->nullable(); // 示例值：'管理员'
        $table->timestamps();
    });
}

1.2 创建用户-角色关联表迁移 #

因为是多对多关系，创建关联表迁移：

php artisan make:migration create_role_user_table

迁移文件内容：

public function up()
{
    Schema::create('role_user', function (Blueprint $table) {
        $table->foreignId('user_id')->constrained()->onDelete('cascade');
        $table->foreignId('role_id')->constrained()->onDelete('cascade');
        $table->primary(['user_id', 'role_id']);
    });
}

1.3 执行迁移 #

php artisan migrate

步骤2：配置模型关联 #

2.1 修改User模型 #

打开app/Models/User.php，添加关联和权限判断方法：

public function roles()
{
    return $this->belongsToMany(Role::class);
}

// 判断用户是否拥有指定角色
public function hasRole($roleName)
{
    return $this->roles()->where('name', $roleName)->exists();
}

2.2 创建Role模型 #

运行命令生成模型：

php artisan make:model Role

在app/Models/Role.php中添加关联：

public function users()
{
    return $this->belongsToMany(User::class);
}

步骤3：创建权限中间件 #

3.1 生成中间件 #

php artisan make:middleware CheckRole

3.2 编写中间件逻辑 #

打开app/Http/Middleware/CheckRole.php，修改handle方法：

public function handle(Request $request, Closure $next, ...$roles)
{
    if (!auth()->check()) {
        return redirect('/login');
    }

    foreach ($roles as $role) {
        if (auth()->user()->hasRole($role)) {
            return $next($request);
        }
    }

    abort(403, '无访问权限');
}

3.3 注册中间件 #

打开app/Http/Kernel.php，在$routeMiddleware数组中添加：

'role' => \App\Http\Middleware\CheckRole::class,

步骤4：路由权限管控 #

在路由文件（如routes/web.php）中用中间件限制访问：

// 仅管理员可访问的路由组
Route::group(['middleware' => ['auth', 'role:admin']], function () {
    Route::get('/admin/users', [UserController::class, 'index'])->name('admin.users');
    Route::post('/admin/users/{user}/assign-role', [UserController::class, 'assignRole'])->name('admin.users.assign-role');
});

// 普通用户可访问的路由
Route::group(['middleware' => ['auth', 'role:user']], function () {
    Route::get('/profile', [ProfileController::class, 'index'])->name('profile');
});

步骤5：实现管理员分配角色功能 #

5.1 在UserController中添加分配方法 #

public function assignRole(Request $request, User $user)
{
    // 确保操作人是管理员
    if (!auth()->user()->hasRole('admin')) {
        abort(403);
    }

    $request->validate([
        'role_id' => 'required|exists:roles,id',
    ]);

    // 替换用户当前角色（若要追加角色，把sync换成attach）
    $user->roles()->sync([$request->role_id]);

    return back()->with('success', '角色分配成功');
}

5.2 分配角色的视图示例 #

在用户管理页面添加表单：

<form action="{{ route('admin.users.assign-role', $user) }}" method="POST">
    @csrf
    <select name="role_id">
        @foreach(\App\Models\Role::all() as $role)
            <option value="{{ $role->id }}" {{ $user->roles->contains($role) ? 'selected' : '' }}>
                {{ $role->display_name ?? $role->name }}
            </option>
        @endforeach
    </select>
    <button type="submit">分配角色</button>
</form>

步骤6：初始化管理员角色和用户 #

6.1 创建种子文件 #

php artisan make:seed RolesTableSeeder
php artisan make:seed UsersTableSeeder

6.2 编写RolesTableSeeder #

public function run()
{
    Role::create([
        'name' => 'admin',
        'display_name' => '管理员'
    ]);
    Role::create([
        'name' => 'user',
        'display_name' => '普通用户'
    ]);
}

6.3 编写UsersTableSeeder #

public function run()
{
    $admin = User::create([
        'name' => '管理员',
        'email' => 'admin@example.com',
        'password' => bcrypt('your-admin-password')
    ]);
    $admin->roles()->attach(Role::where('name', 'admin')->first()->id);
}

6.4 执行种子 #

php artisan db:seed --class=RolesTableSeeder
php artisan db:seed --class=UsersTableSeeder

额外说明 #

• 整个流程不需要安装Node.js或运行npm相关命令，完全基于Laravel后端实现
• 完全复用你最初的User模型和注册逻辑，无需重新搭建项目
• 若后续需要更细粒度的权限管控，可再扩展permissions表，但当前需求下无需额外复杂操作

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