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个层,越上层优先级越高,由上往下依次执行HttpKernelhandle()方法,这些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_proxyDrupal\Core\StackMiddleware\ReverseProxyMiddleware
为请求对象注入反向代理数据,该数据可以定义在站点配置文件settings.php中。


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


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


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


6:http_middleware.sessionDrupal\Core\StackMiddleware\Session
session系统就是这个时候启动的,并将session对象注入了主请求对象中,便于后续使用。


7:http_kernel.basic( Symfony\Component\HttpKernel\HttpKernel
启动 Symfony的HttpKernel,开始进行最里层的请求转为响应过程,精彩还在继续。

 

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

http处理核心堆栈层级图

本书共94小节:

评论 (写第一个评论)