CodeIgniter 4 的请求和响应

CodeIgniter 4 对输入和输出的处理方式作了一个较大的改变。在上一个版本中，包括最新的 V3 版，输入和输出分别是用两个包含相关函数的类来处理的。这样的处理方式背后虽然没有什么高深的技术，但却能简单直接的实现功能。在 V4 版中，咱们将更加模块化 HTTP 层，并构建全新的类结构来同时处理 HTTP 的请求和响应。

概览

在开发 Web 应用时（不一样于 CLI 程序），你只需关心两个类：IncomingRequest 和 Response。

IncomingRequest 类

IncomingRequest 类包含了 HTTP 请求和该请求附带的数据，包括：

• GET、POST、SERVER 和 ENV 等环境变量

• HTTP 请求头

• Cookie

• 当前请求的 URL 对象

• 上传的文件

而且还包括常见的请求信息好比：

• 客户端的 IP 地址

• 是否为 Ajax 请求

• 是否为 CLI 请求

• 是否为 HTTPS

若是你对 IncomingRequest 这个类名感到奇怪，或者说 IncomingRequest 是否是能够简单的称为 Request？答案是否认的，由于已经有另外一个包含 GET 和 POST 等变量的更为通用的 Request 类，但这个类不包括详细的 HTTP 请求信息。一个请求一般只作两件事：一个是浏览器客户端发送请求到服务器（连入），或者是当前服务器发送请求到外部服务器（连出）。

Response 类

Response 类用于把程序的执行结果返回给客户端。你能够设置 HTTP 响应头，或直接发送内容到客户端，等等。Response 类提供了一些便捷方法好比：

• 设置适当的 no-cache 头信息

• 处理 HTTP 缓存头信息

• 重定向页面

一个简单的例子

上面说的这些看起来好像颇有科技含量，但其实很简单。这些类的实例已做为属性放到每一个控制器中，若是你以为很麻烦，则无需直接使用这些属性。Response 类会捕获控制器的输出，并自动设置为响应的主体。一个简单的 Hello World 看起来像这样：

class Home extends \CodeIgniter\Controller
{
    public function index()
    {
        echo "Hello World!";
    }
}

易如反掌。

在须要的时候，框架为你提供了精确控制响应的能力。你能够建立复杂的 HTTP 缓存策略，并与 IncomingRequest 类一块儿经过内容协商定制响应内容。

下面是一个稍微复杂一点的例子，你会发现代码很容易看明白，而且处理的很简单。

class Home extends \CodeIgniter\Controller
{
    public function __construct(...$params)
    {
        parent::__construct(...$params);

        // This controller is only accessible via HTTPS
        if (! $this->request->isSecure())
        {
            // Redirect the user to this page via HTTPS, and set the Strict-Transport-Security
            // header so the browser will automatically convert all links to this page to HTTPS
            // for the next year.
            force_https();
        }
    }

    public function index()
    {
        $data = [
            ...
        ];

        // Set some HTTP cache rules for this page.
        $this->response->setCache([
            'max-age' => 300,
            's-max-age' => 900,
            'etag' => 'foo'
        ]);

        // Return JSON
        $this->response->setContentType('application/json')
                       ->setOutput(json_encode($data));
    }
}

在这个例子中，咱们主要作了三件事。首先，经过将当前 URL 重定向到 HTTPS URL，并设置一个 Strict-Transport-Security 响应头（这种方式已被不少主流浏览器所支持，在发送请求前经过浏览器自动将 HTTP 请求转换成 HTTPS 请求），来强制这个页面以 HTTPS 的方式访问；而后，咱们经过设置一些 HTTP 缓存规则来帮助浏览器正确处理缓存，这意味着能减小 HTTP 请求量，减轻服务器负担，提升性能；最后，咱们输出 JSON 数据给用户，并确保内容类型是正确的。

但愿这篇文章能有助于你们粗略的了解 CodeIgniter 的将来，让你们意识到改变并不可怕。:) 将来将敲定框架更多的细节，直到造成一个相对稳定的架构，而且会撰写更多的文章来说述这些内容。