“中国要复兴、富强,必须在开源软件领域起到主导作用,为了国家安全和人类发展,责无旁贷,我们须为此而奋斗”——By:云客
HttpKernel为何物?从名字可以看出它就是处理http请求的核心,只需要把请求对象传给它,就返回响应对象,一次http访问大体上就算完成了(为什么说是大体上,在实际应用中发送完响应还会做一些类似于析构函数工作的事情),为规范统一HttpKernel的使用symfony为此定义了HttpKernel接口,位于\vendor\symfony\http-kernel\HttpKernelInterface,在drupal中所有HttpKernel定义类都必须要实现该接口,在Druapl中HttpKernel对象并不只有一个,而是有多个,储存于堆栈里,从上到下依次执行,优先级高的位于堆栈上层,从顶层开始执行,上层调用下层,形成一个类似链式结构的处理过程,直到有响应对象产生即终止,下层的HttpKernel可能不被执行,下面详细讲一讲这个过程:
先说一说这个HttpKernel堆栈是怎么产生的:
在drupal中把堆栈里面的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 }
下面我们看一看默认的drupal安装后堆栈里都有哪些处理核心,为便于理解我画了一张示意图:
初始安装的Drupal默认有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:云客【云游天下,做客四方】
反馈互动