[李景山php]每天TP5-20170201|thinkphp5-Request.php-4

    /**
     * 设置获取获取当前请求的参数
     * @access public
     * @param string|array  $name 变量名
     * @param mixed         $default 默认值
     * @param string|array  $filter 过滤方法
     * @return mixed
     */
    public function param($name = '', $default = null, $filter = null)
    {// 设置 或者 获取 当前请求的参数
        if (empty($this->param)) {// 如果当前的参数 为空
            $method = $this->method(true);// 首先 获取方法 也就获取数据的类型
            // 自动获取请求变量
            switch ($method) {// 根据不同的情况 设置
                case 'POST':// post 参数通过 post 方式进行获取
                    $vars = $this->post(false);
                    break;
                case 'PUT':
                case 'DELETE':
                case 'PATCH':
                    $vars = $this->put(false);// 其它的通过 put 方式获取
                    break;
                default:
                    $vars = [];// 默认初始化 空数据
            }
            // 当前请求参数和URL地址中的参数合并
            $this->param = array_merge($this->get(false), $vars, $this->route(false));// 然后 合并 路由 get 及当前获取的参数
            // 最后还都是大杂烩，
        }
        if (true === $name) {// 如果 名字 为真
            // 获取包含文件上传信息的数组
            $file = $this->file();// 包含文件
            $data = array_merge($this->param, $file);// 合并参数 及文件，统称为 data
            return $this->input($data, '', $default, $filter);// 返回 输入的数据
        }
        return $this->input($this->param, $name, $default, $filter);// 返回输入的参数
    }

    /**
     * 设置获取获取路由参数
     * @access public
     * @param string|array  $name 变量名
     * @param mixed         $default 默认值
     * @param string|array  $filter 过滤方法
     * @return mixed
     */
    public function route($name = '', $default = null, $filter = null)
    {// 设置获取路由参数
        if (is_array($name)) {// 如果是数组形式 这个即时优点，也是缺点
            $this->param        = [];// 拼合 参数
            return $this->route = array_merge($this->route, $name);// 返回 路由数据
        }
        return $this->input($this->route, $name, $default, $filter);// 否则 简单的返回
    }

    /**
     * 设置获取获取GET参数
     * @access public
     * @param string|array  $name 变量名
     * @param mixed         $default 默认值
     * @param string|array  $filter 过滤方法
     * @return mixed
     */
    public function get($name = '', $default = null, $filter = null)
    {// get 方式获取参数
        if (empty($this->get)) {// 如果为空
            $this->get = $_GET;
        }
        if (is_array($name)) {// 如果是数组
            $this->param      = [];
            return $this->get = array_merge($this->get, $name);
        }
        return $this->input($this->get, $name, $default, $filter);
    }// 函数内部的容错机制需要特别的强悍

    /**
     * 设置获取获取POST参数
     * @access public
     * @param string        $name 变量名
     * @param mixed         $default 默认值
     * @param string|array  $filter 过滤方法
     * @return mixed
     */
    public function post($name = '', $default = null, $filter = null)
    {
        if (empty($this->post)) {
            $this->post = $_POST;
        }
        if (is_array($name)) {
            $this->param       = [];
            return $this->post = array_merge($this->post, $name);
        }
        return $this->input($this->post, $name, $default, $filter);
    }// 获取 post 数据

    /**
     * 设置获取获取PUT参数
     * @access public
     * @param string|array      $name 变量名
     * @param mixed             $default 默认值
     * @param string|array      $filter 过滤方法
     * @return mixed
     */
    public function put($name = '', $default = null, $filter = null)
    {// 获取 PUT参数
        if (is_null($this->put)) {// 类型1
            $content = file_get_contents('php://input');// 这样的数据流读入
            if (strpos($content, '":')) {// 如果有数据，应该是这个表单
                $this->put = json_decode($content, true);// json 格式解析
            } else {
                parse_str($content, $this->put);// 另外的格式的话，就需要解析字符串
            }
        }
        if (is_array($name)) {// 如果是数组
            $this->param      = [];// 参数获取
            return $this->put = is_null($this->put) ? $name : array_merge($this->put, $name);
        }// 返回参数信息

        return $this->input($this->put, $name, $default, $filter);// 返回 默认的信息
    }

    /**
     * 设置获取获取DELETE参数
     * @access public
     * @param string|array      $name 变量名
     * @param mixed             $default 默认值
     * @param string|array      $filter 过滤方法
     * @return mixed
     */
    public function delete($name = '', $default = null, $filter = null)
    {// 设置获取 delete 参数
        return $this->put($name, $default, $filter);
    }

    /**
     * 设置获取获取PATCH参数
     * @access public
     * @param string|array      $name 变量名
     * @param mixed             $default 默认值
     * @param string|array      $filter 过滤方法
     * @return mixed
     */
    public function patch($name = '', $default = null, $filter = null)
    {
        return $this->put($name, $default, $filter);
    }// 同上的 patch

    /**
     * 获取request变量
     * @param string        $name 数据名称
     * @param string        $default 默认值
     * @param string|array  $filter 过滤方法
     * @return mixed
     */
    public function request($name = '', $default = null, $filter = null)
    {// 请求参数
        if (empty($this->request)) {
            $this->request = $_REQUEST;
        }
        if (is_array($name)) {
            $this->param          = [];
            return $this->request = array_merge($this->request, $name);
        }
        return $this->input($this->request, $name, $default, $filter);
    }

    /**
     * 获取session数据
     * @access public
     * @param string|array  $name 数据名称
     * @param string        $default 默认值
     * @param string|array  $filter 过滤方法
     * @return mixed
     */
    public function session($name = '', $default = null, $filter = null)
    {// session 字段
        if (empty($this->session)) {
            $this->session = Session::get();
        }// 设置session 字段
        if (is_array($name)) {
            return $this->session = array_merge($this->session, $name);
        }// 数组 赋值 组合 返回 一气呵成 这个倒是不错，哈哈
        return $this->input($this->session, $name, $default, $filter);
    }

    /**
     * 获取cookie参数
     * @access public
     * @param string|array  $name 数据名称
     * @param string        $default 默认值
     * @param string|array  $filter 过滤方法
     * @return mixed
     */
    public function cookie($name = '', $default = null, $filter = null)
    {// cookie 参数
        if (empty($this->cookie)) {
            $this->cookie = $_COOKIE;
        }
        if (is_array($name)) {
            return $this->cookie = array_merge($this->cookie, $name);
        }
        return $this->input($this->cookie, $name, $default, $filter);
    }// 同上 类似

    /**
     * 获取server参数
     * @access public
     * @param string|array  $name 数据名称
     * @param string        $default 默认值
     * @param string|array  $filter 过滤方法
     * @return mixed
     */
    public function server($name = '', $default = null, $filter = null)
    {// 获取 server 参数
        if (empty($this->server)) {
            $this->server = $_SERVER;
        }
        if (is_array($name)) {
            return $this->server = array_merge($this->server, $name);
        }
        return $this->input($this->server, false === $name ? false : strtoupper($name), $default, $filter);
    }// 同上

    /**
     * 获取上传的文件信息
     * @access public
     * @param string|array $name 名称
     * @return null|array|\think\File
     */
    public function file($name = '')
    {
        if (empty($this->file)) {
            $this->file = isset($_FILES) ? $_FILES : [];
        }// 如果为空，获取全部信息
        if (is_array($name)) {
            return $this->file = array_merge($this->file, $name);
        }// 信息拼合
        $files = $this->file;// 文件 暂存处理
        if (!empty($files)) {
            // 处理上传文件
            $array = [];
            foreach ($files as $key => $file) {
                if (is_array($file['name'])) {// 如果是多文件上传
                    $item  = [];
                    $keys  = array_keys($file);
                    $count = count($file['name']);
                    for ($i = 0; $i < $count; $i++) {
                        if (empty($file['tmp_name'][$i])) {
                            continue;
                        }
                        $temp['key'] = $key;
                        foreach ($keys as $_key) {
                            $temp[$_key] = $file[$_key][$i];
                        }
                        $item[] = (new File($temp['tmp_name']))->setUploadInfo($temp);
                    }
                    $array[$key] = $item;
                } else {
                    if ($file instanceof File) {// 如果是单独的上传文件
                        $array[$key] = $file;
                    } else {
                        if (empty($file['tmp_name'])) {
                            continue;
                        }
                        $array[$key] = (new File($file['tmp_name']))->setUploadInfo($file);
                    }
                }
            }
            if (strpos($name, '.')) {// 如果文件名的格式比较特殊
                list($name, $sub) = explode('.', $name);
            }
            if ('' === $name) {// 如果 文件名
                // 获取全部文件
                return $array;
            } elseif (isset($sub) && isset($array[$name][$sub])) {// 设置
                return $array[$name][$sub];// 返回子
            } elseif (isset($array[$name])) {
                return $array[$name];
            }
        }
        return null;// 默认 返回空
    }

    /**
     * 获取环境变量
     * @param string|array  $name 数据名称
     * @param string        $default 默认值
     * @param string|array  $filter 过滤方法
     * @return mixed
     */
    public function env($name = '', $default = null, $filter = null)
    {// 获取环境变量
        if (empty($this->env)) {// 如果为空
            $this->env = $_ENV;
        }
        if (is_array($name)) {
            return $this->env = array_merge($this->env, $name);
        }
        return $this->input($this->env, false === $name ? false : strtoupper($name), $default, $filter);
    }// 同上的 其它方式