上海戴文 - Drupal开发 在线教育

你在这里

云客Drupal8源码分析 之 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:云客【云游天下,做客四方】

本文为云客原创,qq群203286137  作者地址http://blog.csdn.net/u011474028

Drupal 版本: 

猜你喜欢