PHPackages                             dh2y/think-auth - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Authentication & Authorization](/categories/authentication)
4. /
5. dh2y/think-auth

ActiveLibrary[Authentication & Authorization](/categories/authentication)

dh2y/think-auth
===============

auth and identity for thinkphp5

2.4(5y ago)46792MITPHPPHP >=5.4.0

Since Apr 27Pushed 5y ago2 watchersCompare

[ Source](https://github.com/cinaofdai/think-auth)[ Packagist](https://packagist.org/packages/dh2y/think-auth)[ RSS](/packages/dh2y-think-auth/feed)WikiDiscussions master Synced 2mo ago

READMEChangelogDependenciesVersions (12)Used By (0)

think-addons
============

[](#think-addons)

The ThinkPHP5 Auth and identity

安装
--

[](#安装)

### 一、执行命令安装

[](#一执行命令安装)

```
composer require dh2y/think-auth

```

或者

### 二、require安装

[](#二require安装)

#### 2-1、 5.0安装

[](#2-1-50安装)

```
"require": {
        "dh2y/think-auth":"1.*"
},

```

#### 2-2、 5.1安装

[](#2-2-51安装)

```
"require": {
        "dh2y/think-auth":"2.*"
},

```

或者

### 三、autoload psr-4标准安装

[](#三autoload-psr-4标准安装)

```
   a) 进入vendor/dh2y目录 (没有dh2y目录 mkdir dh2y)
   b) git clone
   c) 修改 git clone下来的项目名称为think-auth
   d) 添加下面配置
   "autoload": {
        "psr-4": {
            "think\\auth\\": "vendor/dh2y/think-auth/src"
        }
    },
    e) php composer.phar update

```

配置
--

[](#配置)

### 公共配置

[](#公共配置)

```
// auth配置
'auth'  => [
    'auth_on' => 1, // 权限开关
    'auth_type' => 1, // 认证方式，1为实时认证；2为登录认证。
    'auth_group' => 'auth_group', // 用户组数据表名
    'auth_group_access' => 'auth_group_access', // 用户-用户组关系表
    'auth_rule' => 'auth_rule', // 权限规则表
    'auth_user' => 'admin', // 用户信息表
    'menu' =>'menu'
],

```

### 导入数据表

[](#导入数据表)

> `think_` 为自定义的数据表前缀

```
------------------------------
-- think_auth_rule，规则表，
-- id:主键，name：规则唯一标识, title：规则中文名称 status 状态：为1正常，为0禁用，condition：规则表达式，为空表示存在就验证，不为空表示按照条件验证
------------------------------
 DROP TABLE IF EXISTS `think_auth_rule`;
CREATE TABLE `think_auth_rule` (
    `id` mediumint(8) unsigned NOT NULL AUTO_INCREMENT,
      `name` char(80) NOT NULL DEFAULT '',
      `title` char(20) NOT NULL DEFAULT '',
      `status` tinyint(1) NOT NULL DEFAULT '1',
      `condition` char(100) NOT NULL DEFAULT '',
      `mid` int(8) NOT NULL,
      PRIMARY KEY (`id`),
      UNIQUE KEY `name` (`name`) USING BTREE
) ENGINE=MyISAM  DEFAULT CHARSET=utf8;
------------------------------
-- think_auth_group 用户组表，
-- id：主键， title:用户组中文名称， rules：用户组拥有的规则id， 多个规则","隔开，status 状态：为1正常，为0禁用
------------------------------
 DROP TABLE IF EXISTS `think_auth_group`;
CREATE TABLE `think_auth_group` (
   `id` mediumint(8) unsigned NOT NULL AUTO_INCREMENT,
     `title` char(100) NOT NULL DEFAULT '',
     `status` tinyint(1) NOT NULL DEFAULT '1',
     `rules` char(80) NOT NULL DEFAULT '',
     PRIMARY KEY (`id`)
) ENGINE=MyISAM  DEFAULT CHARSET=utf8;
------------------------------
-- think_auth_group_access 用户组明细表
-- uid:用户id，group_id：用户组id
------------------------------
DROP TABLE IF EXISTS `think_auth_group_access`;
CREATE TABLE `think_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=MyISAM DEFAULT CHARSET=utf8;

CREATE TABLE `think_auth__menu` (
  `id` smallint(6) NOT NULL AUTO_INCREMENT,
  `pid` smallint(6) NOT NULL DEFAULT '0',
  `title` varchar(20) NOT NULL COMMENT '菜单名称',
  `link` varchar(50) DEFAULT NULL COMMENT '链接',
  `icon` varchar(50) DEFAULT NULL COMMENT '字体图标',
  `sort` smallint(6) DEFAULT NULL,
  PRIMARY KEY (`id`)
) ENGINE=MyISAM AUTO_INCREMENT=28 DEFAULT CHARSET=utf8 COMMENT='菜单表';

```

原理
--

[](#原理)

Auth权限认证是按规则进行认证。 在数据库中我们有

- 规则表（think\_auth\_rule）
- 用户组表(think\_auth\_group)
- 用户组明显表（think\_auth\_group\_access）

我们在规则表中定义权限规则， 在用户组表中定义每个用户组有哪些权限规则，在用户组明显表中定义用户所属的用户组。

下面举例说明：

我们要判断用户是否有显示一个操作按钮的权限， 首先定义一个规则， 在规则表中添加一个名为 show\_button 的规则。 然后在用户组表添加一个用户组，定义这个用户组有show\_button 的权限规则（think\_auth\_group表中rules字段存得时规则ID，多个以逗号隔开）， 然后在用户组明细表定义 UID 为1 的用户 属于刚才这个的这个用户组。

使用
--

[](#使用)

判断权限方法

```
// 引入类库
use think\auth\Auth;

// 获取auth实例
$auth = Auth::instance();

// 检测权限
if($auth->check('show_button',1)){// 第一个参数是规则名称,第二个参数是用户UID
	//有显示操作按钮的权限
}else{
	//没有显示操作按钮的权限
}

```

Auth类也可以对节点进行认证，我们只要将规则名称，定义为节点名称就行了。 可以在公共控制器Base中定义\_initialize方法

```