6. 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
服务的定义如下:
堆栈里面的HttpKernel
对象不一定会产生响应,它可能只是帮助设置一下请求对象,也可能进行一些功能,请求对象会依次从高层传递到低层。此外用户也可以在自己的模块中定义HttpKernel
对象,高优先级的HttpKernel
可以中断较低优先级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 }
下面我们看一看默认的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
堆栈的结构和流程原理,它是自服务容器以来的又一大步。