权限控制

介绍

imi 框架的权限控制组件，不提供具体 API、管理界面，仅提供基础操作组件。

本组件中支持：角色关联操作，用户关联角色，用于关联操作。

用户除了角色赋予的操作权限以外，还可以单独赋予操作权限。

Composer

本项目可以使用composer安装，遵循psr-4自动加载规则，在你的 composer.json 中加入下面的内容:

{
    "require": {
        "imiphp/imi-access-control": "~2.1.0"
    }
}

然后执行 composer update 安装。

使用

在项目 config/config.php 中配置：

[
    'components'    =>  [
        // 引入本组件
        'AccessControl'    =>  'Imi\AC',
    ],
]

本组件中包含几个数据表，打开本组件目录，找到Model目录，在数据库中建立对应的表，即可使用。
建表这里优先推荐用generate/table：链接

操作权限

引入操作权限操作类

use Imi\AC\AccessControl\Operation;

创建操作权限

Operation::create('权限名称');

// 权限代码不传或为null，则和权限名称相同，不可重复
Operation::create('权限名称', '权限代码');

// 指定父级ID、排序索引
Operation::create('权限名称', '权限代码', $parentId, $index, '介绍');

修改操作权限

// 参数比创建时多了权限id，其余都一样，注意权限id是int类型
Operation::update(权限id, '权限名称', '权限代码', $parentId, $index, '介绍');

删除操作权限

// 注意权限id是int类型
Operation::delete(权限id);

查询操作操作权限列表

// 查询权限列表
$data = Operation::selectList();
// 将列表转换为树状结构
$tree = Operation::listToTree($data);

角色

创建角色

use Imi\AC\AccessControl\Role;

// 与 Operation::create 一样，不多做说明了
$role = Role::create('权限名称', '权限代码', '介绍');

获取角色信息

// 支持ID、Code两种模式
$role = new Role('权限ID');
$role = new Role('权限代码', 'code');
$roleInfo = $role->getRoleInfo(); // $roleInfo->id/code/name/description

获取角色操作权限

// 数组，成员为 \Imi\AC\Model\Operation 类型
$operations = $role->getOperations();

// 树形结构，成员为 \Imi\AC\Model\Filter\OperationTreeItem 类型，$item->children 为其下一级角色，同样为 \Imi\AC\Model\Filter\OperationTreeItem 类型
$operationTree = $role->getOperationTree();

增加、设置角色权限

$role->addOperations('code1', 'code2'); // 只在当前基础上增加这两个权限

$role->setOperations('code1', 'code2'); // 将角色权限设置为仅有这两个权限

移除角色权限

$role->removeOperations('code1', 'code2');

判断角色是否拥有权限

$result = $role->hasOperations('code1', 'code2');

用户

获取该用户所有角色

use Imi\AC\AccessControl\Member;

$memberId = 1;
$member = new Member(1);

$roles = $member->getRoles();

增加、设置角色

$member->addRoles('code1', 'code2'); // 只在当前基础上增加这两个角色

$member->setRoles('code1', 'code2'); // 将用户角色设置为仅有这两个角色

移除角色

$member->removeRoles('code1', 'code2');

判断用户是否拥有角色

$result = $member->hasRoles('code1', 'code2');

获取用户操作权限

// 数组，成员为 \Imi\AC\Model\Operation 类型
$operations = $member->getOperations();

// 树形结构，成员为 \Imi\AC\Model\Filter\OperationTreeItem 类型，$item->children 为其下一级角色，同样为 \Imi\AC\Model\Filter\OperationTreeItem 类型
$operationTree = $member->getOperationTree();

增加、设置用户权限

$member->addOperations('code1', 'code2'); // 只在当前基础上增加这两个权限

$member->setOperations('code1', 'code2'); // 将角色权限设置为仅有这两个权限

移除用户权限

$member->removeOperations('code1', 'code2');

判断用户是否拥有权限

$result = $member->hasOperations('code1', 'code2');