Thinkphp框架感悟（二）

        这次主要分析一下I方法

/**
 * 获取输入参数 支持过滤和默认值
 * 使用方法:
 * <code>
 * I('id',0); 获取id参数 自动判断get或者post
 * I('post.name','','htmlspecialchars'); 获取$_POST['name']
 * I('get.'); 获取$_GET
 * </code>
 * @param string $name 变量的名称 支持指定类型
 * @param mixed $default 不存在的时候默认值
 * @param mixed $filter 参数过滤方法
 * @param mixed $datas 要获取的额外数据源
 * @return mixed
 *
 */
function I($name,$default='',$filter=null,$datas=null) {
   static $_PUT   =  null;

    /**
     * 这个if存在的意义是：I方法有一种写法为I('变量类型.变量名/修饰符');，这种写法可以通过修饰符的不同，将得到的变量强制转换为各个不同的类型
     * 于是就需要一个if来判断是否为带“/”的写法。
     * strpos（）可以查出参数里第一个/的位置，
     *
     * 如果查到了“/”，则用explode将$name字符串拆成两个字符串.
     * explode（）的作用是将$name转换为一维数组，以"/"为标记拆分，
     * 如：$demo = "abcd/12345"; var_dump(explode('/',$demo,2));
     * 得到的结果为   array (size=2)
     *                0 => string 'abcd' (length=4)
     *                1 => string '12345' (length=5)
     *
     * 再通过list函数，将“/”前的字符串赋值给$name,将"/"后面的字符串赋值给$type
     *
     * 结果：$name为“变量类型.变量名”
     *      $type为“修饰符”
     *
     * 如果参数传入时的格式不是I('变量类型.变量名/修饰符')这种，
     * 则查看是否设置“配置参数'VAR_AUTO_STRING'”，该参数的作用是默认强制转换为字符串 $type = 's';
     */
   if(strpos($name,'/')){
      list($name,$type)  =  explode('/',$name,2);
   }elseif(C('VAR_AUTO_STRING')){
        $type   =   's';
    }

    /**
     *这个if的运行过程与上一个if一样，判断传入的参数$name(也可以是经过上面步骤处理过的$name)。
     * 最后变量类型（param、get、post等）被赋值给了$method。变量名被赋值给了$name
     *
     * 如果写的格式为I('变量名')，即没写“.”和变量类型，
     * 则默认变量类型为param
     */
    if(strpos($name,'.')) {
        list($method,$name) =   explode('.',$name,2);
    }else{
        $method =   'param';
    }

    /**
     * strtolower()函数的作用是将字符全部转化为小写
     * 通过$method1的不同，对$input赋不同的传输类型（注：此处的&不是很明白， &的用法是让两个变量指向同一个内容，不知去掉&会怎么样）
     */
    switch(strtolower($method)) {
        case 'get'     :   
           $input =& $_GET;
           break;
        case 'post'    :   
           $input =& $_POST;
           break;
        case 'put'     :   
           if(is_null($_PUT)){
               parse_str(file_get_contents('php://input'), $_PUT);
           }
           $input     =  $_PUT;        
           break;

        /**
         * 此处的$_SERVER是获取系统变量的方法，
         * $_SERVER['REQUEST_METHOD'] 是查看访问页面时的请求方法。例如：“GET”、“HEAD”，“POST”，“PUT”。
         * 从而达到“自动判断请求类型”的目的
         * （所以，无论html页面传过来数据用的传输方法是get还是post，都能用param来接收）
         */
        case 'param'   :
            switch($_SERVER['REQUEST_METHOD']) {
                case 'POST':
                    $input  =  $_POST;
                    break;
                case 'PUT':
                   if(is_null($_PUT)){
                       parse_str(file_get_contents('php://input'), $_PUT);
                   }
                   $input     =  $_PUT;
                    break;
                default:
                    $input  =  $_GET;
            }
            break;

        /**
         * 下面依旧是通过$method1的不同，对$input赋不同的“关键变量名”，用以获取各种系统变量。
         */
        case 'path'    :   
            $input  =   array();
            if(!empty($_SERVER['PATH_INFO'])){
                $depr   =   C('URL_PATHINFO_DEPR');
                $input  =   explode($depr,trim($_SERVER['PATH_INFO'],$depr));            
            }
            break;
        case 'request' :   
           $input =& $_REQUEST;   
           break;
        case 'session' :   
           $input =& $_SESSION;   
           break;
        case 'cookie'  :   
           $input =& $_COOKIE;    
           break;
        case 'server'  :   
           $input =& $_SERVER;    
           break;
        case 'globals' :   
           $input =& $GLOBALS;    
           break;
        case 'data'    :   
           $input =& $datas;      
           break;
        default:
            return null;
    }

    /**
     * 此时$name的内容为变量名，而$input为$_post之类的接收类型变量
     *
     * 如果变量名$name为空，则意味着无变量名传入，传入的只是一个接收类型变量
     * 那么这个接收类型变量里其实是所有的用该类型传输过来的内容（如只有$_POST则是一个数组，里面是各种来自method="post" 的表单中的值）
     * 所以不写变量名代表不是接收特定的键值名传过来的内容，而是接收所有通过“该方法”传过来的内容，并存进“传输类型变量”这个数组里
     * 所以，如果变量名$name为空，我们将整个接收到的数组赋值给$data，
     * 其中isset函数的作用是检测变量是否存在：若变量不存在返回false，若其存在但值为null也返回false，只有存在且值不为null时才返回true
     * 这个$filter是I方法的第二个传入参数，为“参数过滤方法”（一般我都没传过这个参数）,所以当我们传入“参数过滤方法”时，会按我们传入的方法过滤
     *
     * 如果传入的$name不为空
     * 则通过isset函数判断传过来的所有数据（是个二维数组，存放在$input（$_POST之类）里面）里是否有键值名为$name的键值对
     * 如果有，则将数据复制给$data，之后依然判断下是否传入了“参数过滤方法”，如果传入则过滤。
     */
    if(''==$name) { // 获取全部变量
        $data       =   $input;
        $filters    =   isset($filter)?$filter:C('DEFAULT_FILTER');
        if($filters) {
            if(is_string($filters)){
                $filters    =   explode(',',$filters);
            }
            foreach($filters as $filter){
                $data   =   array_map_recursive($filter,$data); // 参数过滤
            }
        }
    }elseif(isset($input[$name])) { // 取值操作
        $data       =   $input[$name];
        $filters    =   isset($filter)?$filter:C('DEFAULT_FILTER');
        if($filters) {
            if(is_string($filters)){
                if(0 === strpos($filters,'/')){
                    if(1 !== preg_match($filters,(string)$data)){
                        // 支持正则验证
                        return   isset($default) ? $default : null;
                    }
                }else{
                    $filters    =   explode(',',$filters);                    
                }
            }elseif(is_int($filters)){
                $filters    =   array($filters);
            }
            
            if(is_array($filters)){
                foreach($filters as $filter){
                    if(function_exists($filter)) {
                        $data   =   is_array($data) ? array_map_recursive($filter,$data) : $filter($data); // 参数过滤
                    }else{
                        $data   =   filter_var($data,is_int($filter) ? $filter : filter_id($filter));
                        if(false === $data) {
                            return   isset($default) ? $default : null;
                        }
                    }
                }
            }
        }
        /**
         * 所以现在$data里面其实装的是传输过来的具体内容。
         * 之后再判断下是否有$type(修饰符，在前面有过详解)，如果$type不为空，则依据$type，将$data转化成不同的类型
         * 如果$type为空，则判定是否传入参数$default（当传输内容不存在时的默认值），如果有$default,则将其赋值给$data
         */
        if(!empty($type)){
           switch(strtolower($type)){
              case 'a':  // 数组
                 $data  =  (array)$data;
                 break;
              case 'd':  // 数字
                 $data  =  (int)$data;
                 break;
              case 'f':  // 浮点
                 $data  =  (float)$data;
                 break;
              case 'b':  // 布尔
                 $data  =  (boolean)$data;
                 break;
                case 's':   // 字符串
                default:
                    $data   =   (string)$data;
           }
        }
    }else{ // 变量默认值
        $data       =    isset($default)?$default:null;
    }

    /**
     * &&这个运算符的意思是：如果前面为假，那么后面的语句就不执行了。
     * array_walk_recursive（）函数的意思是：对数组中的每个元素应用用户自定义的函数（即：将数组$data放入函数think_filter中运算）（关于这个函数目前的用法我还不是很明确）。
     * 最后先判断$data是否为数组，
     * 如果是数组，则运行array_walk_recursive函数（因为array_walk_recursive函数的第一个参数必须得是数组）
     */
    is_array($data) && array_walk_recursive($data,'think_filter');

    /**
     * 最后将$data输出
     */
    return $data;
}