I()函數分析

Thinkphp3.2添加了一個I方法，取義Input，用來擷取前台送出過來的資料。

下面來下I()方法的一些使用技巧：

I方法是放在了/ThinkPHP/Common/function.php之中

/**
     * 擷取輸入參數 支援過濾和預設值
     * 使用方法:
     * <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 參數過濾方法
     * @return mixed
     */
    function I($name,$default='',$filter=null) {
        if(strpos($name,'.')) { // 指定參數來源
            //判斷參數$name中是否包括.号
            list($method,$name) =   explode('.',$name,2);
            //如果包括.号将.号前後分隔，并且分别指派給$method以及$name
        }else{ // 預設為自動判斷
            //如果沒有.号
            $method =   'param';
        }
        switch(strtolower($method)) {//将$method轉換為小寫
            //如果$method為get，則$input為$_GET
            case 'get'     :   $input =& $_GET;break;
            //如果$method為get，則$input為$_POST
            case 'post'    :   $input =& $_POST;break;
            //如果為put，則将post的原始資料轉參數給$input
            case 'put'     :   parse_str(file_get_contents('php://input'), $input);break;
            //如果是param
            case 'param'   :
                //判斷$_SERVER['REQUEST_METHOD']
                switch($_SERVER['REQUEST_METHOD']) {
                    //如果為post，則$input的内容為$_POST的内容
                    case 'POST':
                        $input  =  $_POST;
                        break;
                    //如果為PUT.則input的内容為PUT的内容
                    case 'PUT':
                        parse_str(file_get_contents('php://input'), $input);
                        break;
                    //預設為$_GET的内容
                    default:
                        $input  =  $_GET;
                }
                break;
            //如果$method為request，則$input為$_REQUEST
            case 'request' :   $input =& $_REQUEST;   break;
            //如果$method為session，則$input為$_SESSION
            case 'session' :   $input =& $_SESSION;   break;
            //如果$method為cookie，則$input為$_COOKIE
            case 'cookie'  :   $input =& $_COOKIE;    break;
            //如果$method為server，則$input為$_SERVER
            case 'server'  :   $input =& $_SERVER;    break;
            //如果$method為globals，則$input為$GLOBALS
            case 'globals' :   $input =& $GLOBALS;    break;
            //預設傳回空
            default:
                return NULL;
        }
        /**
         * 到此為止，已經根據傳入的參數的需要（第一個參數.号前面的），把所有的變量都取到了。下面就是傳回變量的内容了。
        **/
        //如果$name為空，也就是I()第一個參數的.号後面為空的時候
        if(empty($name)) { // 擷取全部變量
            //擷取到的變量$input全部複制給$data
            $data       =   $input;
            //array_walk_recursive — 對數組中的每個成員遞歸地應用使用者函數
            //将$data的鍵值作為filter_exp函數的第一個參數，鍵名作為第二個參數
            //如果$data的鍵值中含有or或者exp這兩個字元，自動在後面加一個空格
            array_walk_recursive($data,'filter_exp');
            //判斷過濾參數是否有，如果有的話，就直接使用過濾方法，如果沒有的話，就使用配置中的過濾方法
            $filters    =   isset($filter)?$filter:C('DEFAULT_FILTER');
            if($filters) {
                $filters    =   explode(',',$filters);
                //将過濾參數中的每個方法都應用到$data中
                foreach($filters as $filter){
                    //将$data的每個值使用$filters過濾
                    $data   =   array_map_recursive($filter,$data); // 參數過濾
                }
            }
        }elseif(isset($input[$name])) { // 取值操作
            $data       =   $input[$name];
            is_array($data) && array_walk_recursive($data,'filter_exp');
            $filters    =   isset($filter)?$filter:C('DEFAULT_FILTER');
            if($filters) {
                $filters    =   explode(',',$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;
                        }
                    }
                }
            }
        }else{ // 變量預設值
            $data       =    isset($default)?$default:NULL;
        }
        return $data;
    }