README

简介

RBAC 模块 - Yii2 框架的模块，为管理员提供以下数据管理

• 角色
• 权限
• 为用户（个人资料）分配角色

依赖关系

• php >= 7.1
• composer
• MySql >= 5.5

安装

从远程仓库的通用安装

通过 composer

composer require itstructure/yii2-rbac-module "~3.0.5"

如果您正在本地服务器目录中测试此包

在应用程序 composer.json 文件中设置仓库，如下例所示

"repositories": [
    {
        "type": "path",
        "url": "../yii2-rbac-module",
        "options": {
            "symlink": true
        }
    }
],

这里，

yii2-rbac-module - 目录名，与应用程序处于同一目录级别，并包含 yii2 rbac 模块。

然后运行以下命令

composer require itstructure/yii2-rbac-module:dev-master --prefer-source

附加组件

根据 Yii2 文档，为应用程序设置 authManager

'components' => [
    'authManager' => [
        'class' => 'yii\rbac\DbManager',
    ],
    // ...
],

根据 Yii2 文档，运行以下命令

yii migrate --migrationPath=@yii/rbac/migrations

用法

主要属性

• 模块的 名称： rbac

• 用于类使用的 命名空间： Itstructure\RbacModule.

• 访问模块根目录的 别名： @rbac.

• 没有布局！ 默认情况下，它从应用程序布局 main 获取，或者按照配置。您可以在模块中自定义 layout 属性。

• 视图 组件默认为框架中的 yii\web\View。您可以在模块中自定义 view 组件。

应用程序配置

基本应用程序配置必须如下所示

use Itstructure\RbacModule\Module;
use Itstructure\RbacModule\controllers\{RoleController, PermissionController, ProfileController};

'modules' => [
    'rbac' => [
        'class' => Module::class,
        'controllerMap' => [
            'roles' => RoleController::class,
            'permissions' => PermissionController::class,
            'profiles' => ProfileController::class,
        ],
    ],
],

有用的模块属性

您可以在模块配置中设置以下属性

• loginUrl - 设置未经授权时重定向的 URL。
• accessRoles - 允许与此包一起工作的用户角色。
• urlPrefix - 重定向和视图链接的 URL 前缀（默认为空）。
• urlPrefixNeighbor - 邻近实体的重定向和视图链接的 URL 前缀（默认为空）。

许可证

版权 © 2018-2023 Andrey Girnik girnikandrey@gmail.com.

许可协议为 MIT 许可证。有关详细信息，请参阅 LICENSE.txt。