tp5 auth权限的理解

<?php
// +----------------------------------------------------------------------
// | ThinkPHP [ WE CAN DO IT JUST THINK IT ]
// +----------------------------------------------------------------------
// | Copyright (c) 2011 http://thinkphp.cn All rights reserved.
// +----------------------------------------------------------------------
// | Licensed ( http://www.apache.org/licenses/LICENSE-2.0 )
// +----------------------------------------------------------------------
// | Author: luofei614 <weibo.com/luofei614>　
// +----------------------------------------------------------------------
namespace com;
/**
 * 权限认证类
 * 功能特性：
 * 1，是对规则进行认证，不是对节点进行认证。用户可以把节点当作规则名称实现对节点进行认证。
 *      $auth=new Auth();  $auth->check(‘规则名称‘,‘用户id‘)
 * 2，可以同时对多条规则进行认证，并设置多条规则的关系（or或者and）
 *      $auth=new Auth();  $auth->check(‘规则1,规则2‘,‘用户id‘,‘and‘) 
 *      第三个参数为and时表示，用户需要同时具有规则1和规则2的权限。 当第三个参数为or时，表示用户值需要具备其中一个条件即可。默认为or
 * 3，一个用户可以属于多个用户组(think_auth_group_access表 定义了用户所属用户组)。我们需要设置每个用户组拥有哪些规则(think_auth_group 定义了用户组权限)
 * 
 * 4，支持规则表达式。
 *      在think_auth_rule 表中定义一条规则时，如果type为1， condition字段就可以定义规则表达式。 如定义{score}>5  and {score}<100  表示用户的分数在5-100之间时这条规则才会通过。
 */

//数据库
/*
-- ----------------------------
-- 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 ‘‘,  
    `type` tinyint(1) NOT NULL DEFAULT ‘1‘,    
    `status` tinyint(1) NOT NULL DEFAULT ‘1‘,  
    `condition` char(100) NOT NULL DEFAULT ‘‘,  # 规则附件条件,满足附加条件的规则,才认为是有效的规则
    PRIMARY KEY (`id`),  
    UNIQUE KEY `name` (`name`)
) 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;
 */

class Auth{

    //默认配置
    protected $_config = array(
        ‘auth_on‘           => true,                      // 认证开关
        ‘auth_type‘         => 1,                         // 认证方式，1为实时认证；2为登录认证。
        ‘auth_group‘        => ‘auth_group‘,        // 用户组数据表名
        ‘auth_group_access‘ =>‘auth_group_access‘, // 用户-用户组关系表
        ‘auth_rule‘         => ‘auth_rule‘,         // 权限规则表
        ‘auth_user‘         => ‘member‘             // 用户信息表
    );

    public function __construct() {
        if (config(‘auth_config‘)) {
            //可设置配置项 auth_config, 此配置项为数组。
            $this->_config = array_merge($this->_config, config(‘auth_config‘));
            //不知道config(‘auth_config‘)在哪里配置，有什么参数？
        }
    }

    /**
      * 检查权限
      * @param name string|array  需要验证的规则列表,支持逗号分隔的权限规则或索引数组
      * @param uid  int           认证用户的id
      * @param string mode        执行check的模式
      * @param relation string    如果为 ‘or‘ 表示满足任一条规则即通过验证;如果为 ‘and‘则表示需满足所有规则才能通过验证
      * @return boolean           通过验证返回true;失败返回false
     */
    public function check($name, $uid, $type=1, $mode=‘url‘, $relation=‘or‘) {
        if (!$this->_config[‘auth_on‘]) return true;

        //小写的组下全部权限名称name（一维数组）
        $authList = $this->getAuthList($uid,$type); //获取用户需要验证的所有有效规则列表

        //开始获取当前url下的权限名称name
        if (is_string($name)) {
            $name = strtolower($name);
            if (strpos($name, ‘,‘) !== false) {
                $name = explode(‘,‘, $name);//一维数组
            } else {
                $name = array($name);//一维数组
            }
//            $name = strpos($name, ‘,‘) !== false ? explode(‘,‘, $name) : [$name];
        }
        $list = array(); //保存验证通过的规则名
        if ($mode==‘url‘) {
            //serialize() 返回字符串，此字符串包含了表示 value 的字节流，可以存储于任何地方。
            //strtolower:把所有字符转换为小写：
            //unserialize:从已存储的表示中创建 PHP 的值
            //我觉得这个只有在登录的时候才用到的
            $REQUEST = unserialize( strtolower(serialize($_REQUEST)) );
        }
        
        //两种种比较方法！！！
        //if ($mode==‘url‘ && $query!=$auth )     节点相符且url参数满足
        //in_array($auth , $name)   name在auth存在对应
        
        foreach ( $authList as $auth ) {
            $query = preg_replace(‘/^.+\?/U‘,‘‘,$auth);
            if ($mode==‘url‘ && $query!=$auth ) { //当赋予的权限和url上的路径不一样的时候的做法
                // //把查询字符串解析到变量中：
                parse_str($query,$param); //解析规则中的param
                /*$param = array(1) {
                                         ["controller/index"] => string(0) ""
                                     }*/

                //array_intersect_assoc比较两个数组的键名和键值，并返回交集：
                $intersect = array_intersect_assoc($REQUEST,$param);
                $auth = preg_replace(‘/\?.*$/U‘,‘‘,$auth);
                if ( in_array($auth,$name) && $intersect==$param ) {  //如果节点相符且url参数满足
                    $list[] = $auth ;
                }
            }else if (in_array($auth , $name)){
                $list[] = $auth ;
            }
        }
        
        //  or 和 and
        if ($relation == ‘or‘ and !empty($list)) {
            return true;
        }
        //比较两个数组的键值，并返回差集：
        $diff = array_diff($name, $list);
        if ($relation == ‘and‘ and empty($diff)) {
            return true;
        }
        return false;
    }

    /**
     * 根据用户id获取用户组,返回值为数组
     * @param  uid int     用户id
     * @return array       用户所属的用户组 array(
     *     array(‘uid‘=>‘用户id‘,‘group_id‘=>‘用户组id‘,‘title‘=>‘用户组名称‘,‘rules‘=>‘用户组拥有的规则id,多个,号隔开‘),
     *     ...)   
     */
    public function getGroups($uid) {
        static $groups = array(); //静态，使用第二次直接返回就行
        if (isset($groups[$uid])) return $groups[$uid];

        $user_groups = \think\Db::name($this->_config[‘auth_group_access‘])//用户-用户组关系表
            ->alias(‘a‘)
            ->join($this->_config[‘auth_group‘]." g", "g.id=a.group_id")//用户组数据表名
            ->where("a.uid=‘$uid‘ and g.status=‘1‘")
            ->field(‘uid,group_id,title,rules‘)->select();
        /*$user_groups = Db::view($this->config[‘auth_group_access‘], ‘uid,group_id‘)
                         ->view($this->config[‘auth_group‘], ‘title,rules‘,
                                "{$this->config[‘auth_group_access‘]}.group_id={$this->config[‘auth_group‘]}.id")
                        ->where([‘uid‘ => $uid, ‘status‘ => 1])->select();*/
        $groups[$uid] = $user_groups ? $user_groups : array();
        return $groups[$uid];
    }

    /**
     * 获得权限列表
     * @param integer $uid  用户id
     * @param integer $type 
     */
    protected function getAuthList($uid,$type) {
        static $_authList = array(); //保存用户验证通过的权限列表

        $t = implode(‘,‘,(array)$type);//1

        if (isset($_authList[$uid.$t])) {//           admin_id1
            return $_authList[$uid.$t];
        }

        //登录才需要用到的判断
        if( $this->_config[‘auth_type‘]==2 && isset($_SESSION[‘_auth_list_‘.$uid.$t])){//1 && _auth_list_241
            return $_SESSION[‘_auth_list_‘.$uid.$t];
        }

        //读取用户所属用户组   ‘uid,group_id,title,rules(字符串，权限id)‘二维数组,其实只要一组数据而已【0】
        $groups = $this->getGroups($uid);

        $ids = array();//保存用户所属用户组设置的所有权限规则id
        foreach ($groups as $g) {
            //trim: 移除字符串左侧的字符
            //explode: 把字符串打散为数组
            $ids = array_merge($ids, explode(‘,‘, trim($g[‘rules‘], ‘,‘)));//一维数组
        }
        //array_unique: 移除数组中重复的值
        $ids = array_unique($ids);

        //如果没有权限就返回一个空数组
        if (empty($ids)) {
            $_authList[$uid.$t] = array();
            return array();
        }

        $map=array(
            ‘id‘=>array(‘in‘,$ids),
            ‘type‘=>$type,
            ‘status‘=>1,
        );
        //读取用户组所有权限规则
        $rules = \think\Db::name($this->_config[‘auth_rule‘])->where($map)->field(‘condition,name‘)->select();//二维数组
           /*
            * array(3) {
                      [0] => array(2) {
                        ["condition"] => string(0) ""
                        ["name"] => string(8) "conf/add"
                      }
                      [1] => array(2) {
                        ["condition"] => string(0) ""
                        ["name"] => string(8) "conf/del"
                      }
                      [2] => array(2) {
                        ["condition"] => string(0) ""
                        ["name"] => string(8) "link/del"
                      }
                    }
            * */

        //循环规则，判断结果。
        $authList = array();   //
        foreach ($rules as $rule) {
            if (!empty($rule[‘condition‘])) { //根据condition进行验证
                $user = $this->getUserInfo($uid);//获取用户全部信息,一维数组

                //preg_replace：替一个正则表达式的搜索和替换， 参数一：搜索，参数二：替换，参数三：要搜索替换的目标字符串或字符串数组
                //试了一下，不知道有什么用,$rule[‘condition‘]是什么，输出的也一样，没变！
                //我觉得那个condition就是在这里用正则判断的
                $command = preg_replace(‘/\{(\w*?)\}/‘, ‘$user[\‘\\1\‘]‘, $rule[‘condition‘]);
                //dump($command);//debug
                //eval() 函数把字符串按照 PHP 代码来计算。
                //$$command是什么，$condition就是什么，输出的也一样，没变！
                @(eval(‘$condition=(‘ . $command . ‘);‘));
                if ($condition) {
                    //strtolower: 把所有字符转换为小写:
                    $authList[] = strtolower($rule[‘name‘]);//小写的组下全部权限名称（一维数组）
                }
            } else {
                //只要存在就记录
                $authList[] = strtolower($rule[‘name‘]);
            }
        }
        $_authList[$uid.$t] = $authList;
        if($this->_config[‘auth_type‘]==2){
            //规则列表结果保存到session
            $_SESSION[‘_auth_list_‘.$uid.$t]=$authList;
        }
        return array_unique($authList);
    }

    /**
     * 获得用户资料,根据自己的情况读取数据库
     */
    protected function getUserInfo($uid) {
        static $userinfo=array();
        if(!isset($userinfo[$uid])){
             $userinfo[$uid]=\think\Db::name($this->_config[‘auth_user‘])->where(array(‘uid‘=>$uid))->find();
        }
        return $userinfo[$uid];
    }

}