Laravel实现多角色切换方案咨询（PHP7.2.5+Laravel7.30.6）

针对你已上线的服务环境，无需新增数据表、无需大规模迁移数据的方案如下：

1. 数据库轻量调整 #

直接在现有users表新增一个JSON字段存储用户的可选角色集合，原有role字段保留作为当前激活角色：

1. 生成迁移文件：

php artisan make:migration add_available_roles_to_users_table

2. 编辑迁移文件：

public function up()
{
    Schema::table('users', function (Blueprint $table) {
        $table->json('available_roles')->default(json_encode([]));
    });

    // 初始化现有用户的可选角色为当前角色，无需额外迁移数据
    DB::table('users')->update([
        'available_roles' => DB::raw('JSON_ARRAY(role)')
    ]);
}

public function down()
{
    Schema::table('users', function (Blueprint $table) {
        $table->dropColumn('available_roles');
    });
}

3. 执行迁移：

php artisan migrate

2. 用户模型扩展逻辑 #

在app/User.php中添加角色管理的核心方法：

// 定义角色常量，避免硬编码
const ROLE_ADMIN = 'Admin';
const ROLE_CLIENT = 'Client';

// 允许批量赋值的字段
protected $fillable = [
    // 原有字段...
    'role',
    'available_roles',
];

// 自动转换JSON字段为数组
protected $casts = [
    'available_roles' => 'array',
];

// 获取当前激活角色
public function currentRole()
{
    return $this->role;
}

// 检查用户是否拥有指定可选角色
public function hasRole($role)
{
    return in_array($role, $this->available_roles);
}

// 切换当前角色（验证是否在可选范围内）
public function switchRole($newRole)
{
    if (!$this->hasRole($newRole)) {
        throw new \InvalidArgumentException('该角色不在用户可选范围内');
    }

    $this->role = $newRole;
    return $this->save();
}

// 添加可选角色
public function addAvailableRole($role)
{
    if (!$this->hasRole($role)) {
        $this->available_roles[] = $role;
        $this->available_roles = array_unique($this->available_roles);
        return $this->save();
    }
    return true;
}

// 移除可选角色（保证至少保留一个）
public function removeAvailableRole($role)
{
    if (count($this->available_roles) <= 1) {
        throw new \InvalidArgumentException('用户至少需要保留一个可选角色');
    }

    $this->available_roles = array_filter($this->available_roles, function ($r) use ($role) {
        return $r !== $role;
    });

    // 如果移除的是当前角色，自动切换到第一个可选角色
    if ($this->role === $role) {
        $this->role = reset($this->available_roles);
    }

    return $this->save();
}

3. Nova管理面板配置 #

3.1 用户资源添加角色管理字段 #

在app/Nova/User.php中添加字段，让管理员可视化管理用户角色：

use Laravel\Nova\Fields\Select;
use Laravel\Nova\Fields\Multiselect;

public function fields(Request $request)
{
    $roleOptions = [
        User::ROLE_ADMIN => '管理员',
        User::ROLE_CLIENT => '客户',
        // 可扩展更多角色
    ];

    return [
        // 原有字段...
        Select::make('当前角色', 'role')
            ->options($roleOptions)
            ->rules('required')
            ->onlyOnForms(),

        Multiselect::make('可选角色', 'available_roles')
            ->options($roleOptions)
            ->rules('required', 'array')
            ->help('用户可切换的角色集合，至少选择一个'),
    ];
}

3.2 快速切换角色按钮（可选） #

在Nova用户详情页添加一键切换角色的操作：

use Laravel\Nova\Actions\Action;
use Laravel\Nova\Fields\ActionFields;
use Laravel\Nova\Http\Requests\NovaRequest;

public function actions(NovaRequest $request)
{
    return [
        (new class extends Action {
            public $name = '切换角色';

            public function handle(ActionFields $fields, $models)
            {
                foreach ($models as $user) {
                    $currentIndex = array_search($user->role, $user->available_roles);
                    $nextIndex = ($currentIndex + 1) % count($user->available_roles);
                    $user->switchRole($user->available_roles[$nextIndex]);
                }

                return Action::message('角色切换成功');
            }

            public function fields(NovaRequest $request)
            {
                return [];
            }
        })->showOnDetail(),
    ];
}

4. API接口实现 #

4.1 路由定义 #

在routes/api.php中添加接口路由：

// 用户自主切换角色
Route::post('/user/switch-role', 'UserController@switchRole')->middleware('auth:api');

// 管理员切换指定用户角色（需权限验证）
Route::post('/users/{user}/switch-role', 'Admin\UserController@switchUserRole')->middleware('auth:api', 'role:Admin');

4.2 控制器逻辑 #

用户自主切换角色的方法：

// app/Http/Controllers/UserController.php
public function switchRole(Request $request)
{
    $request->validate([
        'role' => 'required|string',
    ]);

    try {
        auth()->user()->switchRole($request->role);
        return response()->json([
            'message' => '角色切换成功',
            'current_role' => auth()->user()->role,
        ]);
    } catch (\InvalidArgumentException $e) {
        return response()->json(['error' => $e->getMessage()], 400);
    }
}

管理员切换用户角色的方法：

// app/Http/Controllers/Admin/UserController.php
public function switchUserRole(Request $request, User $user)
{
    $request->validate([
        'role' => 'required|string',
    ]);

    try {
        $user->switchRole($request->role);
        return response()->json([
            'message' => '用户角色切换成功',
            'user' => $user,
        ]);
    } catch (\InvalidArgumentException $e) {
        return response()->json(['error' => $e->getMessage()], 400);
    }
}

5. 权限验证中间件 #

创建角色验证中间件，控制接口/页面访问权限：

// app/Http/Middleware/RoleMiddleware.php
public function handle($request, Closure $next, ...$roles)
{
    if (!auth()->check() || !in_array(auth()->user()->role, $roles)) {
        abort(403, '无权限访问');
    }

    return $next($request);
}

在app/Http/Kernel.php注册中间件：

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

使用示例：

// 仅允许Admin角色访问
Route::get('/admin/dashboard', 'AdminController@dashboard')->middleware('role:Admin');

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