PrestaShop自定义模块权限配置求助：如何设置特定用户组访问权限

我之前也碰到过这个问题——PrestaShop的权限管控文档确实藏得比较深，但其实它是基于Symfony的权限体系做了封装适配，下面是具体的实现步骤，亲测有效：

1. 先给你的模块注册专属权限项 #

首先得在模块的安装逻辑里注册一个自定义权限，这样系统才能识别它。你可以在模块的install()方法里添加这段代码：

public function install()
{
    // 先执行默认安装逻辑
    if (!parent::install()) {
        return false;
    }

    // 注册自定义权限，名称最好带模块前缀避免冲突
    $permissionAdded = Permission::add([
        'name' => 'access_my_custom_module',
        'tab' => 'AdminMyCustomModule', // 这里填你模块后台控制器的tab名称
    ]);

    return $permissionAdded;
}

这里的tab参数要和你模块后台控制器的$this->tab属性保持一致，不然权限会找不到对应的入口。

2. 把权限关联到指定用户组 #

有两种方式可以给用户组分配权限：

方式一：安装模块时自动分配（适合默认给管理员组开通） #

如果想让模块安装后自动给管理员组开放权限，可以在刚才的install()方法里继续加这段：

// 获取管理员组的ID
$adminGroupId = Group::getIdByName('Administrator');
if ($adminGroupId && $permissionAdded) {
    $permissionId = Permission::getIdByName('access_my_custom_module');
    // 把权限绑定到管理员组
    Db::getInstance()->insert('group_permission', [
        'id_group' => (int)$adminGroupId,
        'id_permission' => (int)$permissionId,
    ]);
}

方式二：让用户在后台手动配置（更灵活） #

用户可以自己在PrestaShop后台操作：进入 高级参数 > 权限 > 用户组，编辑目标用户组，在权限列表里找到你刚才注册的access_my_custom_module权限，勾选保存就可以了。

3. 在模块后台控制器里做权限校验 #

最后一步是在你的模块后台控制器里校验当前登录员工是否有这个权限，没有的话就拒绝访问。比如在控制器的checkAccess()方法里做校验：

class AdminMyCustomModuleController extends ModuleAdminController
{
    public function __construct()
    {
        parent::__construct();
        $this->bootstrap = true;
    }

    public function checkAccess()
    {
        // 先继承父类的权限校验，再加上我们自定义的权限
        return parent::checkAccess() && Employee::getCurrent()->hasPermission('access_my_custom_module');
    }
}

要是员工没有权限，系统会自动跳转到后台首页并提示无权限，非常省心。

4. 卸载模块时清理权限（可选但推荐） #

为了避免数据库里留下冗余数据，最好在模块的uninstall()方法里删除我们注册的权限：

public function uninstall()
{
    // 先删除用户组和权限的关联
    $permissionId = Permission::getIdByName('access_my_custom_module');
    if ($permissionId) {
        Db::getInstance()->delete('group_permission', 'id_permission = '.(int)$permissionId);
        // 再删除权限本身
        Db::getInstance()->delete('permission', 'id_permission = '.(int)$permissionId);
    }

    return parent::uninstall();
}

这样一套下来，就能精准控制只有指定用户组的员工才能访问你的自定义模块了。

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