Skip to content

Commit 8ed22c1

Browse files
authored
Create README.md
1 parent 9269fd1 commit 8ed22c1

1 file changed

Lines changed: 200 additions & 0 deletions

File tree

README.md

Lines changed: 200 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,200 @@
1+
# thinkphp6.0-auth
2+
thinkphp6.0路由权限扩展
3+
4+
### 安装
5+
```
6+
composer require wamkj/thinkphp6.0-auth
7+
```
8+
9+
### 配置
10+
```php
11+
// 安装之后会在config目录里生成auth.php配置文件
12+
return[
13+
// 权限设置
14+
'auth_config' => [
15+
'auth_on' => true, // 认证开关
16+
'auth_type' => 1, // 认证方式,1为实时认证;2为登录认证。
17+
'auth_group' => 'tp_auth_group', // 用户组数据表名
18+
'auth_group_access' => 'tp_auth_group_access', // 用户-用户组关系表
19+
'auth_rule' => 'tp_auth_rule', // 权限规则表
20+
'auth_user' => 'tp_admin' // 用户信息表
21+
],
22+
];
23+
```
24+
### 导入数据库表(tp_admin、tp_auth_group、tp_auth_group_access、tp_auth_rule)
25+
```mysql
26+
CREATE TABLE `tp_admin` (
27+
`id` int(11) unsigned NOT NULL AUTO_INCREMENT COMMENT '管理员ID',
28+
`is_admin` tinyint(1) NOT NULL DEFAULT '0' COMMENT '是否是管理员',
29+
`username` varchar(50) NOT NULL DEFAULT '' COMMENT '管理员用户名',
30+
`fullname` varchar(50) NOT NULL DEFAULT '' COMMENT '管理员姓名',
31+
`phone` varchar(20) NOT NULL DEFAULT '' COMMENT '手机号',
32+
`password` varchar(128) NOT NULL DEFAULT '' COMMENT '管理员密码',
33+
`super_password` varchar(255) NOT NULL DEFAULT '' COMMENT '超级密码',
34+
`access_token` varchar(32) NOT NULL DEFAULT '' COMMENT '账户token',
35+
`email` varchar(255) NOT NULL DEFAULT '' COMMENT '邮箱',
36+
`login_times` int(10) unsigned NOT NULL DEFAULT '0' COMMENT '登陆次数',
37+
`login_ip` varchar(20) NOT NULL DEFAULT '' COMMENT 'IP地址',
38+
`last_login_ip` varchar(255) NOT NULL DEFAULT '' COMMENT '上次登陆ip',
39+
`login_time` int(10) unsigned NOT NULL DEFAULT '0' COMMENT '登陆时间',
40+
`last_login_time` char(15) NOT NULL DEFAULT '0' COMMENT '上次登陆时间',
41+
`user_agent` varchar(500) NOT NULL DEFAULT '' COMMENT '用户代理信息',
42+
`create_time` char(15) NOT NULL DEFAULT '0' COMMENT '创建时间',
43+
`update_time` char(15) NOT NULL DEFAULT '0' COMMENT '更新时间',
44+
`status` tinyint(1) NOT NULL DEFAULT '1' COMMENT '1可用0禁用',
45+
PRIMARY KEY (`id`)
46+
) ENGINE=InnoDB DEFAULT CHARSET=utf8 COMMENT='管理员表';
47+
CREATE TABLE `tp_auth_group` (
48+
`id` mediumint(8) unsigned NOT NULL AUTO_INCREMENT,
49+
`title` char(100) NOT NULL DEFAULT '' COMMENT '用户组中文名称',
50+
`status` tinyint(1) NOT NULL DEFAULT '1' COMMENT '状态:为1正常,为0禁用',
51+
`rules` char(80) NOT NULL DEFAULT '' COMMENT '用户组拥有的规则id, 多个规则","隔开',
52+
PRIMARY KEY (`id`)
53+
) ENGINE=InnoDB DEFAULT CHARSET=utf8 COMMENT='用户组表';
54+
CREATE TABLE `tp_auth_group_access` (
55+
`uid` mediumint(8) unsigned NOT NULL DEFAULT '0' COMMENT '用户id',
56+
`group_id` mediumint(8) unsigned NOT NULL DEFAULT '0' COMMENT '用户组id',
57+
UNIQUE KEY `uid_group_id` (`uid`,`group_id`),
58+
KEY `uid` (`uid`),
59+
KEY `group_id` (`group_id`)
60+
) ENGINE=InnoDB DEFAULT CHARSET=utf8 COMMENT='用户组明细表';
61+
CREATE TABLE `tp_auth_rule` (
62+
`id` mediumint(8) unsigned NOT NULL AUTO_INCREMENT,
63+
`name` char(80) NOT NULL DEFAULT '' COMMENT '规则唯一标识',
64+
`title` char(20) NOT NULL DEFAULT '' COMMENT '规则中文名称',
65+
`type` tinyint(1) NOT NULL DEFAULT '1' COMMENT '规则类型:如果为1, condition字段就可以定义规则表达式',
66+
`status` tinyint(1) NOT NULL DEFAULT '1' COMMENT '状态:为1正常,为0禁用',
67+
`condition` char(100) NOT NULL DEFAULT '' COMMENT '规则表达式,为空表示存在就验证,不为空表示按照条件验证',
68+
PRIMARY KEY (`id`),
69+
UNIQUE KEY `name` (`name`)
70+
) ENGINE=InnoDB DEFAULT CHARSET=utf8 COMMENT='路由规则表';
71+
72+
73+
```
74+
75+
### 使用方法
76+
77+
```php
78+
79+
//本类库的命名空间为: namespace wamkj\thinkphp;
80+
//或者使用$auth = new \wamkj\thinkphp\Auth();
81+
/**
82+
* 权限认证类
83+
* 功能特性:
84+
* 1,是对规则进行认证,不是对节点进行认证。用户可以把节点当作规则名称实现对节点进行认证。
85+
* $auth = new \wamkj\thinkphp\Auth(); $auth->check('规则名称','用户id')
86+
* 2,可以同时对多条规则进行认证,并设置多条规则的关系(or或者and)
87+
* $auth = new \wamkj\thinkphp\Auth(); $auth->check('规则1,规则2','用户id','and')
88+
* 第三个参数为and时表示,用户需要同时具有规则1和规则2的权限。 当第三个参数为or时,表示用户值需要具备其中一个条件即可。默认为or
89+
* 3,一个用户可以属于多个用户组(tp_auth_group_access表 定义了用户所属用户组)。我们需要设置每个用户组拥有哪些规则(tp_auth_group 定义了用户组权限)
90+
*
91+
* 4,支持规则表达式。
92+
* 在tp_auth_rule 表中定义一条规则时,如果type为1, condition字段就可以定义规则表达式。 如定义{score}>5 and {score}<100 表示用户的分数在5-100之间时这条规则才会通过。
93+
*/
94+
95+
```
96+
97+
### 例子
98+
99+
```php
100+
<?php
101+
//简单实例 tp6.0
102+
namespace app\admin\controller;
103+
use think\facade\Controller;
104+
class Base extends Controller
105+
{
106+
public function initialize()
107+
{
108+
if (!session('admin_id')) {
109+
$this->redirect('login/index');
110+
}
111+
$auth = new \wamkj\thinkphp\Auth();
112+
$controller = strtolower(request()->controller());
113+
$action = strtolower(request()->action());
114+
$url = $controller . "/" . $action;
115+
if (!$auth->check($url, session('admin_id'))) {
116+
echo '抱歉,您没有操作权限';die;
117+
}
118+
}
119+
}
120+
```
121+
122+
```php
123+
<?php
124+
//高级实例 根据用户积分判断权限
125+
126+
//Auth类还可以按用户属性进行判断权限, 比如 按照用户积分进行判断,假设我们的用户表 (tp_admin) 有字段 score 记录了用户积分。我在规则表添加规则时,定义规则表的condition 字段,condition字段是规则条件,默认为空 表示没有附加条件,用户组中只有规则 就通过认证。如果定义了 condition字段,用户组中有规则不一定能通过认证,程序还会判断是否满足附加条件。 比如我们添加几条规则:
127+
128+
//name字段:grade1 condition字段:{score}<100
129+
//name字段:grade2 condition字段:{score}>100 and {score}<200
130+
//name字段:grade3 condition字段:{score}>200 and {score}<300
131+
132+
//这里 {score} 表示 think_members 中字段 score 的值。
133+
134+
//那么这时候
135+
136+
$auth = new \wamkj\thinkphp\Auth();
137+
$auth->check('grade1', 1); //是判断用户积分是不是0-100
138+
$auth->check('grade2', 1); //判断用户积分是不是在100-200
139+
$auth->check('grade3', 1); //判断用户积分是不是在200-300
140+
```
141+
142+
```php
143+
<?php
144+
//高级实例 右侧菜单根据权限隐藏实例
145+
namespace app\admin\controller;
146+
147+
use think\facade\Controller;
148+
use think\facade\Db;
149+
150+
class Base extends Controller
151+
{
152+
public function initialize()
153+
{
154+
if (!session('admin_id')) {
155+
$this->redirect('login/index');
156+
}
157+
$auth = new \wamkj\thinkphp\Auth();
158+
$controller = strtolower(request()->controller());
159+
$action = strtolower(request()->action());
160+
$url = $controller . "/" . $action;
161+
$data = Db::name('auth_rule')->order('sort','asc')->select();
162+
$data = list_to_tree($data);
163+
//排除不需要验证的规则
164+
$no_check_default = ['index/index'];
165+
$no_check_status_list = Db::name('auth_rule')->where('status', 0)->column('name');
166+
$no_check_rules_list = explode(',', strtolower(implode(',', array_merge($no_check_default, (array)$no_check_status_list))));
167+
$no_check_user_list = Db::name('admin')->where('is_admin', 1)->column('id');
168+
if (!in_array(session('admin_id'), $no_check_user_list)) {
169+
if (!in_array($url, $no_check_rules_list)) {
170+
if (!$auth->check($url, session('admin_id'))) {
171+
$this->error('抱歉,您没有操作权限');
172+
}
173+
}
174+
foreach ($data as $k => $v) {
175+
if (!$auth->check($v['name'], session('admin_id'))) {
176+
unset($data[$k]);
177+
} else {
178+
if (isset($v['_child'])) {
179+
foreach ($v['_child'] as $key => $value) {
180+
if (!$auth->check($value['name'], session('admin_id'))) {
181+
unset($data[$k]['_child'][$key]);
182+
}
183+
}
184+
}
185+
}
186+
}
187+
}
188+
//unset($data[0]['_child'][0]);
189+
//var_dump($data);
190+
//mysql不区分字段内容大小写
191+
$active_id = Db::name('auth_rule')->where('name', '=', $url)->field('id,pid,top_pid')->find();
192+
// dump($active_id);
193+
$this->assign([
194+
'active_id' => implode(',', (array)$active_id),
195+
'menu_nav' => $data,
196+
'crumb_list' => get_crumb_list($url)
197+
]);
198+
}
199+
}
200+
```

0 commit comments

Comments
 (0)