# thinkphp6.0权限扩展
auth package for thinkphp6
# 安装
> composer require ltxlong/thinkphp6-auth
# [](https://github.com/ltxlong/thinkphp6-auth#%E9%85%8D%E7%BD%AE)配置
~~~
// auth配置 自定义数据表位置在 ./config/auth.php里面
[
'auth_on' => 1, // 权限开关
'auth_type' => 1, // 认证方式，1为实时认证；2为登录认证。
'auth_group' => 'auth_group', // 用户组数据表(不带前缀表名)
'auth_group_access' => 'auth_group_access', // 用户-用户组关系表(不带前缀表名)
'auth_rule' => 'auth_rule', // 权限规则表(不带前缀表名)
'auth_user' => 'user', // 用户信息表(不带前缀表名)
]
// 注意：condition里的变量是用户表（配置auth_user的值的表，通常配置为用户表）的字段
// （当然，不配置auth_user的值为用户表，而是其他表，那也行的！但是，condition里的变量只能是配置的表里面的字段）
// （如配置auth_user的值为integral积分表，那么condition里的变量就只能是integral表里面的字段）
// condition里的变量用花括号括住，如：{score}
// 表的前缀在框架的数据库配置那配置，这里的配置的表都是不带前缀的
~~~
# [](https://github.com/ltxlong/thinkphp6-auth#%E5%AF%BC%E5%85%A5%E6%95%B0%E6%8D%AE%E8%A1%A8)导入数据表
~~~
----------------------------------------------------------------------------
-- auth_rule，规则表，
-- id:主键，
-- name：规则唯一标识, title：规则中文名称 status 状态：为1正常，为0禁用
-- name 可以自定义名称，也可以是模块/控制器/方法、模块_控制器_方法、控制器/方法、控制器_方法、控制器-方法
-- condition：规则表达式，为空表示存在就验证，不为空表示按照条件验证
-- condition 简单来说，如果字段为空，则只验证name就行；如果字段不为空，则在验证了name的基础上，还要验证字段里面的条件
-- condition 条件，是user表的字段条件（准确来说，是auth_user配置的表），如 {score} > 10
----------------------------------------------------------------------------
DROP TABLE IF EXISTS `auth_rule`;
CREATE TABLE `auth_rule` (
`id` mediumint(8) unsigned NOT NULL AUTO_INCREMENT,
`name` varchar(80) NOT NULL DEFAULT '',
`title` varchar(20) NOT NULL DEFAULT '',
`status` tinyint(1) NOT NULL DEFAULT 1,
`condition` varchar(100) NOT NULL DEFAULT '',
PRIMARY KEY (`id`),
UNIQUE KEY `name` (`name`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
----------------------------------------------------------------------------
-- auth_group 用户组表，
-- id：主键， title:用户组中文名称， rules：用户组拥有的规则id， 多个规则","隔开，status 状态：为1正常，为0禁用
----------------------------------------------------------------------------
DROP TABLE IF EXISTS `auth_group`;
CREATE TABLE `auth_group` (
`id` mediumint(8) unsigned NOT NULL AUTO_INCREMENT,
`title` varchar(100) NOT NULL DEFAULT '',
`status` tinyint(1) NOT NULL DEFAULT 1,
`rules` varchar(80) NOT NULL DEFAULT '',
PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
----------------------------------------------------------------------------
-- auth_group_access 用户-用户组关系表
-- uid:用户id，group_id：用户组id
----------------------------------------------------------------------------
DROP TABLE IF EXISTS `auth_group_access`;
CREATE TABLE `auth_group_access` (
`uid` mediumint(8) unsigned NOT NULL,
`group_id` mediumint(8) unsigned NOT NULL,
UNIQUE KEY `uid_group_id` (`uid`,`group_id`),
KEY `uid` (`uid`),
KEY `group_id` (`group_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
~~~
# [](https://github.com/ltxlong/thinkphp6-auth#%E5%8E%9F%E7%90%86)原理
Auth权限认证是按规则进行认证。 在数据库中我们有
* 规则表（auth\_rule）
* 用户组表 （auth\_group）
* 用户-用户组关系表（auth\_group\_access）
我们在规则表中定义权限规则， 在用户组表中定义每个用户组有哪些权限规则，在用户组明显表中定义用户所属的用户组。
下面举例说明：
我们要判断用户是否有显示一个操作按钮的权限， 首先定义一个规则， 在规则表中添加一个名为 show\_button 的规则。 然后在用户组表添加一个用户组，定义这个用户组有show\_button 的权限规则（auth\_group表中rules字段存得时规则ID，多个以逗号隔开）， 然后在用户组明细表定义 UID 为1 的用户 属于刚才这个的这个用户组。
# [](https://github.com/ltxlong/thinkphp6-auth#%E4%BD%BF%E7%94%A8)使用
判断权限方法
~~~
// 引入类库
use think\auth\Auth;
// 获取auth实例
$auth = Auth::instance();
// 检测权限
if ($auth->check('show_button', 1)) { // 第一个参数是规则名称, 第二个参数是用户UID
//有显示操作按钮的权限
} else {
//没有显示操作按钮的权限
}
~~~
Auth类也可以对节点进行认证，我们只要将规则名称，定义为节点名称就行了。 可以在自定义的公共控制器Base中定义\_initialize方法
~~~
<?php
use think\auth\Auth;
use app\BaseController;
class adminBaseController extends BaseController
{
public function _initialize()
{
parent::initialize();
$controller = request()->controller();
$action = request()->action();
$auth = new Auth();
if(!$auth->check($controller . '/' . $action, session('uid'))){
$this->error('你没有权限访问');
}
}
}
~~~
这时候我们可以在数据库中添加的节点规则， 格式为： “控制器名称/方法名称”
使用了多应用的情况下，如果想获取当前模块名称，可以这样：
~~~
$module = app('http')->getName();
~~~
Auth 类 还可以多个规则一起认证 如：
~~~
$auth->check(['rule1', 'rule2'], uid);
~~~
或者
~~~
$auth->check('rule1,rule2', uid);
~~~
表示 认证用户只要有rule1的权限或rule2的权限，只要有一个规则的权限，认证返回结果就为true 即认证通过。 默认多个权限的关系是 “or” 关系，也就是说多个权限中，只要有个权限通过则通过。
我们也可以定义为 “and” 关系
~~~
$auth->check(['rule1', 'rule2'], uid, 'and');
~~~
或者
~~~
$auth->check('rule1,rule2', uid, 'and');
~~~
Auth认证，一个用户可以属于多个用户组。 比如我们对 show\_button这个规则进行认证， 用户A 同时属于 用户组1 和用户组2 两个用户组 ， 用户组1 没有show\_button 规则权限， 但如果用户组2 有show\_button 规则权限，则一样会权限认证通过。
~~~
$auth->getGroups(uid)
~~~
通过上面代码，可以获得用户所属的所有用户组，方便我们在网站上面显示。
Auth类还可以按用户属性进行判断权限， 比如 按照用户积分进行判断， 假设我们的用户表 (user) 有字段 score 记录了用户积分。 我在规则表添加规则时，定义规则表的condition 字段，condition字段是规则条件，默认为空 表示没有附加条件，用户组中只有规则 就通过认证。 如果定义了 condition字段，用户组中有规则不一定能通过认证，程序还会判断是否满足附加条件。 比如我们添加几条规则：
> name字段：grade1 condition字段：{score}<100
>
> name字段：grade2 condition字段：{score}>100 && {score}<200
>
> name字段：grade3 condition字段：{score}>200 && {score}<300
这里 {score} 表示 user 表 中字段 score 的值。
那么这时候
> $auth->check('grade1', uid) 是判断用户积分是不是0-100
>
> $auth->check('grade2', uid) 判断用户积分是不是在100-200
>
> $auth->check('grade3', uid) 判断用户积分是不是在200-300
condition 支持的运算符号：
~~~
>= > <= < && == || !=
~~~
注意：condition表达式不支持括号()，不支持单引号''，也不支持双引号""
复杂点的condition:
~~~
{score}<50 && {score}<100 || {name}!=abc
~~~
# [](https://github.com/ltxlong/thinkphp6-auth#%E6%9C%80%E5%90%8E)最后
因为觉得eval()函数不安全，所以自己写了个简单的函数来运算condition
- 空白目录
- 数据表的创建
- auth _rule
- auth_group
- auth_group_access
- 权限示例
- Auth权限菜单
- Auth用户组权限修改
- Auth用户规则表
- Auth权限的使用
- 源码示例
- thinkphp6auth
- 安装与拓展
- auth
- thinkphp6.0权限扩展
- ThinkPHP3.2.3完整版中对Auth.class.php的使用
- ThinkPHP6.x中对Auth的使用[tp6-auth权限管理]
- Thinkphp6+Auth+LayuiAdmin+authtree权限管理
- 使用phpstudy安装
- 使用宝塔安装thinkphp
- thinkphp6 伪静态配置(nginx和Apache)
- apiadmin安装教程