在Laravel中用Spatie Roles and Permissions管理两类团队权限

针对你的场景，这里提供几种无需修改包核心源码的可行方案，优先推荐多态关联扩展和模型重写+类型字段两种实现方式：

方案1：基于多态关联扩展（推荐） #

通过将团队关联改为多态关系，让权限/角色可以关联Company或Project模型，完美兼容两种团队类型。

步骤1：修改权限相关迁移 #

创建新的迁移文件，为roles和permissions表添加多态字段：

Schema::table('roles', function (Blueprint $table) {
    $table->dropColumn('team_id'); // 移除原有的单外键
    $table->morphs('team'); // 生成team_id和team_type字段
});

Schema::table('permissions', function (Blueprint $table) {
    $table->dropColumn('team_id');
    $table->morphs('team');
});

步骤2：重写Spatie的Role和Permission模型 #

创建自定义模型继承Spatie的原模型，重写团队关联：

// app/Models/Role.php
namespace App\Models;

use Spatie\Permission\Models\Role as SpatieRole;

class Role extends SpatieRole
{
    public function team()
    {
        return $this->morphTo();
    }

    // 重写团队筛选作用域
    public function scopeForTeam($query, $team)
    {
        return $query->where('team_type', get_class($team))
            ->where('team_id', $team->id);
    }
}

// app/Models/Permission.php
namespace App\Models;

use Spatie\Permission\Models\Permission as SpatiePermission;

class Permission extends SpatiePermission
{
    public function team()
    {
        return $this->morphTo();
    }

    public function scopeForTeam($query, $team)
    {
        return $query->where('team_type', get_class($team))
            ->where('team_id', $team->id);
    }
}

步骤3：配置包使用自定义模型 #

在config/permission.php中更新模型路径：

'models' => [
    'role' => App\Models\Role::class,
    'permission' => App\Models\Permission::class,
],

步骤4：使用示例 #

// 给用户分配公司团队角色
$company = Company::find(1);
$user->assignRole('company-admin', $company);

// 给用户分配项目团队角色
$project = Project::find(1);
$user->assignRole('project-editor', $project);

// 检查公司团队权限
if ($user->hasPermissionTo('manage-company-users', $company)) {
    // 执行操作
}

// 检查项目团队权限
if ($user->hasPermissionTo('edit-project-content', $project)) {
    // 执行操作
}

方案2：添加团队类型字段，复用单外键 #

如果不想改多态，也可以保留原有的team_id，新增team_type字段区分公司/项目，然后重写模型逻辑。

步骤1：修改迁移 #

Schema::table('roles', function (Blueprint $table) {
    $table->string('team_type')->nullable(); // 存储App\Models\Company或App\Models\Project
});

Schema::table('permissions', function (Blueprint $table) {
    $table->string('team_type')->nullable();
});

步骤2：重写Role模型的作用域和关联 #

class Role extends SpatieRole
{
    public function scopeForCompany($query, Company $company)
    {
        return $query->where('team_type', Company::class)
            ->where('team_id', $company->id);
    }

    public function scopeForProject($query, Project $project)
    {
        return $query->where('team_type', Project::class)
            ->where('team_id', $project->id);
    }
}

步骤3：使用示例 #

// 创建公司角色
Role::create([
    'name' => 'company-manager',
    'team_id' => 1,
    'team_type' => Company::class,
]);

// 检查项目权限（需重写hasPermissionTo方法接收team_type参数）
if ($user->hasProjectPermission('view-project', $project)) {
    // 执行操作
}

最佳实践 #

• 永远不要直接修改Spatie包的核心文件，通过继承模型和自定义迁移实现扩展，避免包更新时丢失修改。
• 对于复杂的多团队场景，优先选择多态关联方案，它更符合Laravel的关联设计规范，扩展性更强。
• 可以封装自定义的权限辅助函数，比如hasCompanyPermission()、hasProjectPermission()，简化业务代码中的权限判断。

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