ThinkPHP6进阶教程:如何优雅地使用Auth模块进行权限验证
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组件来实现。