[李景山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);}// 同上的 其它方式