如何构建基于角色与权限的模块化管理表格结构-html教程-PHP中文网

如何构建基于角色与权限的模块化管理表格结构

本文介绍如何使用 laravel + spatie laravel permission 构建清晰、可维护的角色-权限分配表格界面，支持按模块（如用户、订单、文章）分组设置 view/create/edit/delete 权限，并实现后端校验与自动权限创建。

本文介绍如何使用 laravel + spatie laravel permission 构建清晰、可维护的角色-权限分配表格界面，支持按模块（如用户、订单、文章）分组设置 view/create/edit/delete 权限，并实现后端校验与自动权限创建。

在权限管理系统中，常见的需求是为不同角色（如管理员、编辑、审核员）分配细粒度的模块级操作权限（如“用户模块 → 查看/创建/编辑/删除”）。原始代码将权限按行遍历、角色横向重复渲染，导致结构混乱且无法对齐模块维度；而理想结构应以模块为行、操作类型为列、角色权限状态为复选框，形成直观的二维矩阵。

✅ 正确的前端结构设计

核心思路是：固定模块列表，动态渲染每模块下的四类权限复选框，而非按权限对象循环。以下是一个标准 Blade 模板示例（兼容 Bootstrap 5 + Spatie）：

@csrf

角色名称

模块权限配置

模块	查看	创建	编辑	删除
用户管理
订单管理

? 关键要点：

name="permissions[]" 统一收集所有勾选的权限字符串（如 "users.view"），便于后端批量同步；

使用 in_array() 判断当前角色是否已拥有某权限，实现表单回显；

模块名硬编码或从配置/数据库读取，确保前后端权限命名一致（推荐 module.action 格式）。

⚙️ 后端权限同步逻辑（Controller）

在控制器中，需确保权限存在后再绑定至角色。推荐封装为服务类，但最小可行实现如下：

use Spatie\Permission\Models\Role;
use Spatie\Permission\Models\Permission;
use Illuminate\Support\Facades\DB;

public function store(Request $request)
{
    $request->validate([
        'role_name' => 'required|string|max:191|unique:roles,name',
        'permissions' => 'array',
        'permissions.*' => 'string|exists:permissions,name'
    ]);

    $permissions = $request->input('permissions', []);

    DB::beginTransaction();
    try {
        // 创建角色
        $role = Role::create(['name' => $request->role_name]);

        // 自动创建缺失权限（避免手动 seed）
        foreach ($permissions as $permissionName) {
            Permission::firstOrCreate(
                ['name' => $permissionName],
                ['guard_name' => 'web']
            );
        }

        // 同步权限（覆盖式，确保精准）
        $role->syncPermissions($permissions);

        DB::commit();
        return redirect()->route('settings.roles.index')->with('success', '角色创建成功！');
    } catch (\Exception $e) {
        DB::rollBack();
        throw $e;
    }
}