如何在Filament-Approvals中基于角色权限控制菜单显示

如何在Filament-Approvals中基于角色权限控制菜单显示

filament-approvals 项目地址: https://gitcode.com/gh_mirrors/fi/filament-approvals

Filament-Approvals是一个用于Laravel Filament的审批流程管理包，在实际项目中，我们经常需要根据不同用户角色来控制菜单的可见性。本文将详细介绍如何通过Laravel Policy来实现这一功能。

问题背景

默认情况下，Filament-Approvals的菜单可以通过修改config/approvals.php文件中的should_register_navigation配置项来控制显示或隐藏。但这种方式是全局性的，无法根据不同用户角色进行差异化控制。

解决方案

1. 创建Policy

首先需要为ProcessApprovalFlow模型创建一个Policy类。这个Policy将定义各种操作（查看、创建、更新等）的权限控制逻辑。

use App\Models\User;
use EightyNine\Approvals\Models\ProcessApprovalFlow;
use Illuminate\Auth\Access\HandlesAuthorization;

class ProcessApprovalFlowPolicy
{
    use HandlesAuthorization;

    public function viewAny(User $user): bool
    {
        return $user->can('view_any_approval::flow');
    }

    public function view(User $user, ProcessApprovalFlow $processApprovalFlow): bool
    {
        return $user->can('view_approval::flow');
    }

    // 其他方法如create、update、delete等...
}

2. 注册Policy

由于ProcessApprovalFlow模型位于vendor目录下，Laravel不会自动发现其Policy，因此需要手动注册。在AppServiceProvider的boot方法中添加：

public function boot(): void
{
    Gate::policy(ProcessApprovalFlow::class, ProcessApprovalFlowPolicy::class);
}

3. 权限控制原理

当Policy注册后，Filament会自动检查当前用户对ProcessApprovalFlow模型的viewAny权限。如果返回false，相应的导航菜单将不会显示。

4. 权限分配

在实际应用中，你需要通过角色管理系统（如Spatie Laravel Permission）为用户分配相应的权限：

// 给管理员角色分配审批流程管理权限
$adminRole->givePermissionTo('view_any_approval::flow');
$adminRole->givePermissionTo('create_approval::flow');
// 其他权限...

注意事项

1. 确保你的用户模型使用了正确的trait（如Laravel的Authorizable trait）

2. 权限名称中的双冒号(::)是Filament的标准命名方式，表示模块划分

3. 对于复杂的权限场景，可以在Policy方法中实现更精细的控制逻辑

总结

通过Laravel Policy机制，我们可以灵活控制Filament-Approvals菜单的显示。这种方法不仅适用于Approval Flows模块，也可以推广到Filament中的其他资源管理。关键在于正确创建Policy并确保其被注册到对应的模型上。

这种基于权限的菜单控制方式比简单的配置开关更加灵活和安全，适合需要精细化权限管理的企业级应用场景。

filament-approvals 项目地址: https://gitcode.com/gh_mirrors/fi/filament-approvals