Yii2 rbac权限配置

Yii2 的 RBAC (Role-Based Access Control) 是一种灵活且强大的访问控制方法，它允许你通过角色来管理用户的权限。下面是一个 Yii2 RBAC 的完整开发步骤概述：
1. 配置 RBAC 组件
在你的 config/web.php 文件中，确保 RBAC 组件已经正确配置：

'components' => [  
    'authManager' => [  
        'class' => 'yii\rbac\DbManager',  
        // 如果你使用的是自定义的表名，可以在这里设置  
        // 'itemTable' => 'your_item_table',  
        // 'assignmentTable' => 'your_assignment_table',  
        // 'ruleTable' => 'your_rule_table',  
    ],  
    // ... 其他组件配置 ...  
],

2. 创建 RBAC 数据表

Yii2 提供了用于创建 RBAC 数据表的迁移命令：

./yii migrate/create create_rbac_tables

然后，你需要在生成的迁移文件中添加 up 方法的内容，用于创建必要的表。通常，你可以使用 Yii2 提供的 m140506_102106_rbac_init 迁移作为参考。

3. 初始化 RBAC 数据
在命令行中运行以下命令来初始化 RBAC 数据：

./yii rbac/init

这将创建一些默认的角色和权限，例如 guest 和 admin。
4. 定义权限和角色
使用 Yii2 的 RBAC API 来定义你的权限和角色。例如：

use yii\rbac\DbManager;  
$auth = Yii::$app->authManager;  
// 添加权限  
$createPost = $auth->createPermission('createPost');  
$createPost->description = 'Create a post';  
$auth->add($createPost);  
  
// 添加角色  
$admin = $auth->createRole('admin');  
$auth->add($admin);  
  
// 将权限赋给角色  
$auth->addChild($admin, $createPost);

5. 分配角色给用户
你可以将角色分配给用户，这样用户就拥有了该角色所拥有的所有权限：

use yii\rbac\DbManager;  
$auth = Yii::$app->authManager;  
// 获取用户ID  
$userId = Yii::$app->user->id;  
  
// 获取角色  
$admin = $auth->getRole('admin');  
  
// 分配角色给用户  
$auth->assign($admin, $userId);

6. 在控制器和动作中检查权限
在你的控制器或动作中，你可以使用 Yii2 的 AccessControl 行为或直接在代码中检查用户的权限：

use yii\filters\AccessControl;  
use yii\web\Controller;  
use yii\filters\VerbFilter;  
use yii\rbac\DbManager;  
  
class PostController extends Controller  
{  
    public function behaviors()  
    {  
        return [  
            'access' => [  
                'class' => AccessControl::class,  
                'rules' => [  
                    [  
                        'allow' => true,  
                        'roles' => ['admin'],  
                    ],  
                ],  
            ],  
            'verbs' => [  
                'class' => VerbFilter::class,  
                'actions' => [  
                    'delete' => ['POST'],  
                ],  
            ],  
        ];  
    }  
      
    // ... 其他控制器方法 ...  
}

或者，你可以在代码中直接检查：

if (Yii::$app->user->can('createPost')) {  
    // 用户有创建帖子的权限  
} else {  
    // 用户没有创建帖子的权限  
}

7. 自定义访问控制规则（续）
首先，创建自定义规则类，继承自 yii\rbac\Rule 类，并实现 execute 方法：

namespace app\rbac;  
  
use yii\rbac\Rule;  
  
class PostAuthorRule extends Rule  
{  
    public $name = 'isPostAuthor';  
  
    /**  
     * @param string|int $user 用户ID或用户名  
     * @param Item $item 权限或角色  
     * @param array $params 传递给规则的参数  
     * @return bool 返回true表示权限可以赋予用户，false表示不能  
     */  
    public function execute($user, $item, $params)  
    {  
        if (!isset($params['post'])) {  
            return false;  
        }  
        return $params['post']->created_by == $user;  
    }  
}

然后，在你的 RBAC 初始化或配置代码中，添加这个规则到 RBAC 系统中：

use yii\rbac\DbManager;  
use app\rbac\PostAuthorRule;  
  
// ...  
  
$auth = Yii::$app->authManager;  
  
// 添加自定义规则  
$rule = new PostAuthorRule;  
$auth->add($rule);  
  
// 创建权限，并将规则关联到权限上  
$updateOwnPost = $auth->createPermission('updateOwnPost');  
$updateOwnPost->description = 'Update own post';  
$updateOwnPost->ruleName = $rule->name; // 将规则关联到权限  
$auth->add($updateOwnPost);  

// ...

在上面的代码中，我们创建了一个名为 updateOwnPost 的权限，并将之前创建的 PostAuthorRule 规则关联到这个权限上。这意味着，只有当用户是帖子的创建者时，他们才拥有 updateOwnPost 权限。
8. 在控制器中使用自定义规则
在你的控制器中，你可以检查用户是否有某个特定的权限，例如 updateOwnPost：

use yii\web\Controller;  
use Yii;  
  
class PostController extends Controller  
{  
    public function actionUpdate($id)  
    {  
        $post = Post::findOne($id);  
        if (!$post) {  
            throw new NotFoundHttpException('Post not found.');  
        }  
  
        if (!Yii::$app->user->can('updateOwnPost', ['post' => $post])) {  
            throw new ForbiddenHttpException('You are not allowed to update this post.');  
        }  
  
        // ... 允许用户更新帖子的代码 ...  
    }  
}

在上面的代码中，我们使用 Yii::$app->user->can() 方法来检查用户是否有权限更新帖子。我们传递了额外的参数 ['post' => $post]，这样 RBAC 系统就会使用我们之前定义的 PostAuthorRule 规则来检查权限。
9. 注意事项
    确保你的 Post 模型有一个 created_by 属性，它保存了创建帖子的用户ID。
    根据你的应用逻辑，你可能需要创建更多的自定义规则和权限。
    始终确保你的 RBAC 逻辑是安全且符合你的应用需求的。

通过遵循这些步骤，你应该能够在 Yii2 应用中实现一个功能强大的 RBAC 系统，从而灵活管理用户的权限和角色。