云客Drupal源码分析之HttpKernel堆栈

HttpKernel为何物？从名字可以看出它就是处理http请求的核心，只需要把请求对象传给它，就返回响应对象，一次http访问大体上就算完成了（为什么说是大体上，在实际应用中发送完响应还会做一些类似于析构函数工作的事情），为规范统一HttpKernel的使用symfony为此定义了HttpKernel接口，位于\vendor\symfony\http-kernel\HttpKernelInterface，在drupal8中所有HttpKernel定义类都必须要实现该接口，在Druapl8中HttpKernel对象并不只有一个，而是有多个，储存于堆栈里，从上到下依次执行，优先级高的位于堆栈上层，从顶层开始执行，上层调用下层，形成一个类似链式结构的处理过程，直到有响应对象产生即终止，下层的HttpKernel可能不被执行，下面详细讲一讲这个过程：

先说一说这个HttpKernel堆栈是怎么产生的：

在drupal8中把堆栈里面的HttpKernel对象称之为http_middleware（http中间件），堆栈于服务容器编译阶段确定（容器在Drupal\Core\DrupalKernel中形成），对此堆栈的编译过程定义在\core\lib\Drupal\Core\DependencyInjection\Compiler\StackedKernelPass.php，在编译容器的时候这个CompilerPass收集所有被标记为http_middleware的服务（这样的服务必须实现HttpKernelInterface接口），并依据优先级进行排序，将最高优先级的HttpKernel和这个排好序的数组分别作为堆栈管理对象StackedHttpKernel的第一和第二个参数，在容器中$container->get('http_kernel')取出http_kernel服务的时候取出的就是这个堆栈管理对象了，这里顺便提一下如何定义堆栈中的HttpKernel服务，该服务必须实现HttpKernel接口，并标记为http_middleware，额外可以设置priority（优先级，没有设置默认为0）、responder（响应器，能产生响应对象时设置为真），比如页面缓存HttpKernel服务的定义如下：

 

services:
  http_middleware.page_cache:
    class: Drupal\page_cache\StackMiddleware\PageCache
    arguments: ['@cache.render', '@page_cache_request_policy', '@page_cache_response_policy']
    tags:
      - { name: http_middleware, priority: 200, responder: true }

堆栈里面的HttpKernel对象不一定会产生响应，它可能只是帮助设置一下请求对象，也可能进行一些功能，请求对象会依次从高层传递到低层。此外用户也可以在自己的模块中定义HttpKernel对象，高优先级的HttpKernel可以中断较低优先级HttpKernel的执行。

 

下面我们看一看默认的drupal8安装后堆栈里都有哪些处理核心，为便于理解我画了一张示意图：

初始安装的Drupal8默认有7个处理核心，依据优先级，它们在堆栈中形成7个层，越上层优先级越高，由上往下依次执行HttpKernel的handle（）方法，这些HttpKernel可选择的实现TerminableInterface接口，如果实现，它们的terminate（）方法也是从上到下依次执行，整个堆栈的实现可以看一看StackedHttpKernel类的实现，位于\vendor\stack\builder\src\Stack\StackedHttpKernel.php，下面分别看一看这7个HttpKernel都干了什么：

1：http_middleware.negotiation（ Drupal\Core\StackMiddleware\NegotiationMiddleware）

用于进行内容协商，它会在请求对象里面设置请求的格式，然后调用下一层的handle()方法是它的责任

2：http_middleware.reverse_proxy（Drupal\Core\StackMiddleware\ReverseProxyMiddleware）

为请求对象注入反向代理数据，该数据可以定义在站点配置文件settings.php中

3：ban.middleware（Drupal\ban\BanMiddleware）

它就是管理后台/扩展模块里面的Ban模块，它查询数据库获得不允许访问站点的IP，如果是禁止的ip则终断下层HttpKernel的处理，给出内容为拒绝访问的响应对象，如果你想快速学习模块开发，那么核心的Ban模块是很好的教程，里面有服务定义、权限定义、菜单定义、表单定义、数据库操作、路由定义等等，它可以成为你借鉴的第一个模块开发案例

4：http_middleware.page_cache（Drupal\page_cache\StackMiddleware\PageCache）

缓存层，根据请求对象查找是否有缓存的数据，有则直接产生响应，否则继续下层的处理，并把可缓存的响应缓存起来供以后使用，它其实就是管理后台/扩展模块里面的Internal Page Cache模块，默认是不能关闭的

5：http_middleware.kernel_pre_handle（Drupal\Core\StackMiddleware\KernelPreHandle）

对请求进行预处理，你也许已经研读过DrupalKernel类的代码了，当时可能你疑惑里面的preHandle方法是什么时候调用的，没错，就是这个HttpKernel层的工作，它加载\core\includes里面的许多函数库、加载模块函数库、注册流包装器、建立请求堆栈等等，这个层仅仅为下层的处理进行许多准备工作

6：http_middleware.session（Drupal\Core\StackMiddleware\Session）

session系统就是这个时候启动的，并将session对象注入了主请求对象中，便于后续使用

7：http_kernel.basic（ Symfony\Component\HttpKernel\HttpKernel）

启动 Symfony的HttpKernel，开始进行最里层的请求转为响应过程，精彩还在继续

 

好了，这就是HttpKernel堆栈的结构和流程原理，它是自服务容器以来的又一大步

by:云客【云游天下，做客四方】

 

我是云客,【云游天下，做客四方】,联系方式见主页，欢迎转载，但须注明出处