在Laravel与Jetstream中实现多角色权限访问方案咨询

1. 给用户表添加角色字段 #

首先需要在users表中添加角色标识字段，用来区分管理员、讲师、学生：

• 生成迁移文件：

php artisan make:migration add_role_to_users_table

• 打开生成的迁移文件，修改up方法：

public function up()
{
    Schema::table('users', function (Blueprint $table) {
        $table->enum('role', ['admin', 'lecturer', 'student'])->default('student');
    });
}

• 执行迁移：

php artisan migrate

• 在User模型中添加常量和快捷判断方法，方便后续调用：

class User extends Authenticatable
{
    use HasApiTokens, HasFactory, Notifiable;

    const ROLE_ADMIN = 'admin';
    const ROLE_LECTURER = 'lecturer';
    const ROLE_STUDENT = 'student';

    // ... 其他原有代码

    public function isAdmin(): bool
    {
        return $this->role === self::ROLE_ADMIN;
    }

    public function isLecturer(): bool
    {
        return $this->role === self::ROLE_LECTURER;
    }

    public function isStudent(): bool
    {
        return $this->role === self::ROLE_STUDENT;
    }
}

2. 自定义登录后跳转逻辑 #

Jetstream基于Fortify实现认证，需要修改登录成功后的重定向规则，根据角色跳转到对应仪表盘：

• 创建自定义重定向处理类：

php artisan make:middleware RedirectIfAuthenticated

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

public function handle(Request $request, Closure $next, ...$guards)
{
    $guards = empty($guards) ? [null] : $guards;

    foreach ($guards as $guard) {
        if (Auth::guard($guard)->check()) {
            $user = Auth::user();
            if ($user->isAdmin()) {
                return redirect()->route('admin.dashboard');
            } elseif ($user->isLecturer()) {
                return redirect()->route('lecturer.dashboard');
            } else {
                return redirect()->route('student.dashboard');
            }
        }
    }

    return $next($request);
}

• 打开app/Providers/FortifyServiceProvider.php，在boot方法中替换默认重定向逻辑：

public function boot()
{
    $this->app->singleton(
        \Laravel\Fortify\Contracts\RedirectsUsers::class,
        \App\Http\Middleware\RedirectIfAuthenticated::class
    );

    // ... 其他原有代码
}

3. 创建角色权限中间件 #

为确保不同角色只能访问自己的仪表盘路由，需要创建角色校验中间件：

• 生成中间件：

php artisan make:middleware CheckRole

• 打开app/Http/Middleware/CheckRole.php，编写校验逻辑：

public function handle(Request $request, Closure $next, ...$roles)
{
    if (!in_array(Auth::user()->role, $roles)) {
        abort(403, '无权访问该页面');
    }

    return $next($request);
}

• 打开app/Http/Kernel.php，在routeMiddleware数组中注册中间件：

protected $routeMiddleware = [
    // ... 原有中间件
    'role' => \App\Http\Middleware\CheckRole::class,
];

4. 配置角色专属路由 #

在routes/web.php中为不同角色配置独立的路由组：

// 管理员路由组
Route::middleware(['auth', 'role:admin'])->group(function () {
    Route::get('/admin/dashboard', [AdminDashboardController::class, 'index'])->name('admin.dashboard');
    // 其他管理员专属路由
});

// 讲师路由组
Route::middleware(['auth', 'role:lecturer'])->group(function () {
    Route::get('/lecturer/dashboard', [LecturerDashboardController::class, 'index'])->name('lecturer.dashboard');
    // 其他讲师专属路由
});

// 学生路由组
Route::middleware(['auth', 'role:student'])->group(function () {
    Route::get('/student/dashboard', [StudentDashboardController::class, 'index'])->name('student.dashboard');
    // 其他学生专属路由
});

5. 创建对应仪表盘控制器和视图 #

• 生成控制器：

php artisan make:controller AdminDashboardController
php artisan make:controller LecturerDashboardController
php artisan make:controller StudentDashboardController

• 在每个控制器的index方法中返回对应视图（以管理员控制器为例）：

public function index()
{
    return view('admin.dashboard');
}

• 创建对应的视图文件，比如resources/views/admin/dashboard.blade.php、resources/views/lecturer/dashboard.blade.php等，编写各自的仪表盘内容。

额外说明 #

• 如果需要区分注册入口（比如管理员只能后台创建，学生/讲师可自行注册），可以修改Jetstream的注册逻辑，或在后台添加用户管理功能手动分配角色。
• 测试时可直接修改数据库中用户的role字段，验证不同角色的跳转和路由访问权限。

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