ThinkPHP6进阶教程：如何优雅地使用Auth模块进行权限验证

一时失言乱红尘 2024-04-29 11:38 40阅读 0赞

thinkphp6是一款优秀的php框架，它为我们提供了很多高效的工具和功能。其中，auth授权是一个非常强大的功能，可以帮助我们在应用程序中进行权限管理。本文将介绍如何使用thinkphp6的auth授权。

**安装Auth组件**

首先，我们需要安装Auth组件。在终端中执行以下命令：

composer require topthink/think-auth

安装完成后，我们需要在配置文件中添加Auth服务提供者：

// config/app.php
    
    return [
        // ...
        'providers' => [
            // ...
            thinkuthServiceProvider::class,
        ],
    ];

然后，我们需要执行以下命令生成Auth配置文件：

php think auth:config

**配置Auth组件**

Auth组件可以通过配置来实现不同的权限管理需求，下面是一个基础的配置：

// config/auth.php
    
    return [
        'auth_on' => true,
        'auth_type' => 1,
        'auth_group' => 'auth_group',
        'auth_group_access' => 'auth_group_access',
        'auth_rule' => 'auth_rule',
        'auth_user' => 'user',
    ];

*  auth\_on：是否开启权限认证，true开启，false关闭；
 *  auth\_type：认证方式，1为实时认证（即每次验证权限时都重新获取权限），2为登录认证（即用户登录后验证权限）；
 *  auth\_group：用户组数据表名；
 *  auth\_group\_access：用户组明细关联表名；
 *  auth\_rule：权限规则表；
 *  auth\_user：用户信息表。

**创建权限规则**

在使用Auth授权之前，我们需要先创建一些权限规则。权限规则可以控制用户对不同资源的访问权限。我们需要在数据库中创建一个auth\_rule表，然后通过添加记录的方式来创建权限规则。

// appmodelAuthRule.php
    
    namespace appmodel;
    
    use thinkModel;
    
    class AuthRule extends Model
    {
        //
    }

接下来，我们需要在数据库中创建auth\_rule表：

CREATE TABLE `auth_rule` (
        `id` INT NOT NULL AUTO_INCREMENT,
        `name` VARCHAR(100) NOT NULL COMMENT '规则',
        `title` VARCHAR(100) NOT NULL COMMENT '规则名称',
        `type` TINYINT(1) UNSIGNED NOT NULL DEFAULT '1' COMMENT '规则类型',
        `status` TINYINT(1) UNSIGNED NOT NULL DEFAULT '1' COMMENT '状态',
        `condition` TEXT COMMENT '规则表达式',
        PRIMARY KEY (`id`)
    ) ENGINE=INNODB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8mb4 COMMENT='权限规则表';

然后，我们可以通过以下方式添加一些权限规则：

use appmodelAuthRule;
    
    $rule = new AuthRule;
    $rule->name = 'admin/user/index';
    $rule->title = '管理用户';
    $rule->save();
    
    $rule = new AuthRule;
    $rule->name = 'admin/user/add';
    $rule->title = '添加用户';
    $rule->save();
    
    $rule = new AuthRule;
    $rule->name = 'admin/user/edit';
    $rule->title = '编辑用户';
    $rule->save();
    
    $rule = new AuthRule;
    $rule->name = 'admin/user/del';
    $rule->title = '删除用户';
    $rule->save();

**创建用户组**

除了权限规则外，我们还需要创建用户组。用户组是一些用户的集合，拥有相同的访问权限。我们需要在数据库中创建一个auth\_group表，然后通过添加记录的方式来创建用户组。

// appmodelAuthGroup.php
    
    namespace appmodel;
    
    use thinkModel;
    
    class AuthGroup extends Model
    {
        //
    }

接下来，我们需要在数据库中创建auth\_group表：

CREATE TABLE `auth_group` (
        `id` INT NOT NULL AUTO_INCREMENT,
        `title` VARCHAR(100) NOT NULL COMMENT '组名',
        `status` TINYINT(1) UNSIGNED NOT NULL DEFAULT '1' COMMENT '状态',
        PRIMARY KEY (`id`)
    ) ENGINE=INNODB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8mb4 COMMENT='用户组表';

然后，我们可以通过以下方式添加一些用户组：

use appmodelAuthGroup;
    
    $group = new AuthGroup;
    $group->title = '管理员';
    $group->save();
    
    $group = new AuthGroup;
    $group->title = '普通用户';
    $group->save();

**创建用户组明细**

现在，我们已经创建了一些权限规则和用户组。接下来，我们需要将规则分配给用户组。我们需要在数据库中创建一个auth\_group\_access表，然后通过添加记录的方式来创建用户组明细。

// appmodelAuthGroupAccess.php
    
    namespace appmodel;
    
    use thinkModel;
    
    class AuthGroupAccess extends Model
    {
        //
    }

接下来，我们需要在数据库中创建auth\_group\_access表：

CREATE TABLE `auth_group_access` (
        `uid` INT NOT NULL COMMENT '用户id',
        `group_id` INT NOT NULL COMMENT '用户组id',
        UNIQUE KEY `uid_group_id` (`uid`, `group_id`),
        KEY `uid` (`uid`),
        KEY `group_id` (`group_id`)
    ) ENGINE=INNODB DEFAULT CHARSET=utf8mb4 COMMENT='用户组明细表';

然后，我们可以通过以下方式将权限规则分配给用户组：

use appmodelAuthGroupAccess;
    
    $access = new AuthGroupAccess;
    $access->uid = 1;
    $access->group_id = 1;
    $access->save();
    
    $access = new AuthGroupAccess;
    $access->uid = 2;
    $access->group_id = 2;
    $access->save();
    
    $access = new AuthGroupAccess;
    $access->uid = 3;
    $access->group_id = 2;
    $access->save();

**使用Auth授权**

现在，我们已经创建了一些权限规则和用户组，并将规则分配给了用户组。接下来，我们可以使用Auth授权来验证用户是否有访问权限。

// 授权验证
    use thinkacadeSession;
    use thinkacadeRequest;
    use thinkacadeConfig;
    use thinkacadeDb;
    use thinkuthAuth;
    
    class BaseController extends Controller
    {
        protected function initialize()
        {
            parent::initialize();
    
            // 如果用户未登录，则跳转到登录页面
            if (!Session::has('user')) {
                $this->redirect('/login');
            }
    
            $uid = Session::get('user.id');
    
            // 如果是超级管理员，则直接通过权限验证
            if ($uid == Config::get('admin_id')) {
                return true;
            }
    
            $auth = new Auth;
            $route = strtolower(Request::controller() . '/' . Request::action());
            if (!$auth->check($route, $uid)) {
                $this->error('无权限');
            }
        }
    }

首先，我们需要从Session中获取用户登录信息。如果用户未登录，则跳转到登录页面。

然后，我们获取当前用户的uid。如果当前用户是超级管理员，则直接通过权限验证。

否则，我们创建一个Auth实例，并获取当前请求的路由。然后，我们使用Auth的check方法验证当前用户是否有访问权限。如果没有，则抛出一个无权限的错误。

**小结**

在本文中，我们学习了如何使用ThinkPHP6的Auth授权。我们使用Auth组件来实现权限管理，并创建了一些权限规则和用户组。最后，我们使用Auth授权来验证用户是否有访问权限。如果您需要更高级的权限管理功能，可以通过扩展Auth组件来实现。