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