多应用+插件架构,代码干净,二开方便,首家独创一键云编译技术,文档视频完善,免费商用码云13.8K 广告
# 中间件 [TOC] ## 简单描述 这里的中间件其实跟HOOK的功能是有点类似的,定义一连串的操作来执行某一项处理,使用中间件主要是对请求进行拦截,方便把一些业务处理分隔开方便管理。 ## HOOK和中间件区别 1. 中间件是链式执行的,上一个中间件执行完毕主动调用下一个中间件,如果不调用就会中断,全部执行完后返回最后一个中间件的执行结果 2. HOOK是串连一些操作如果上一个操作返回`false`则中断执行,如果所有操作都不返回`false`,则会执行完所有操作后返回一个结果数组 中间件的入口执行方法默认是`handle`方法,而且第一个参数是`Request`对象,第二个参数是一个闭包。 中间件的命令空间没有强制要求,但建议和框架的命名空间保持一至,命名规则为 **middleware/模块/中间件名字**, ## 中间件定义 定义一个中间件数组,单个中间件的格式如下 * [[中间件类,方法],[参数,参数]] * [闭包/函数/静态方法,[参数,参数]] 数组的长度最多两个, 第一个是【中间件类,方法】或【闭包/函数/静态方法】, 第二个是【参数1,参数2】会做为参数传入中间件的方法中, 第三个 **bool** 值 ,标识如果是类的话是否创建新的实例,默认为false不创建,这一次请求中如果一个中间件会被多次调用的话,这个参数可以避免重复使用带来的一些问题 >第一个为中间件类(默认调用 handle,如果是个数组,则第二个参数为类或函数的方法,第二个往后以次为要输入的参数,第一个如果只是一个类名的话也可以传字符串,默认会调用handle方法, ### 参数传递规则 * 第一个参数为request对象, 第二个参数为闭包回调(\Closure $next),固定不变 * 从三个参数开始依次传入中间件调度时传入的参数,如果dispatch有参数则会优先从第三个函数插入,然后中间件中定义的参数才会依次插入传递 * ## 单独使用方法 ``` php // 要过滤的数据 $data=[ ‘name’=>'名字', 'mobile'=>'16600000000', 'money'=>1000 ]; $midlist=[ [[\middleware\index\Search::class], ['nameasdfasf']], //没有参数就直接写类名 [[\middleware\index\Second::class],[]] ]; // 实例化要执行中间的对象 $middleware = new Middleware(); // 导入中间件列表 $middleware->import($midlist); // 添加一个中间件 //$middleware->add( [[\middleware\index\Second::class],[]] ); // 调度中间件执行 $moddleware->dispatch(&$data); // 最后使用data ``` ## 控制器中使用中间件 ### 业务场景 中间件主要用于,把数据拦截过来进行处理然后再放行或直接返回响应结果,例如有一个数组,最终目的是要输出的,可以在输出之前定义一组中间件(总监->财务->销售总监->组长->业务员),数据会按这个顺序依次传引用进入中间件中处理,最终才会显示。 如果以后有一个职位取消的话直接删除这个中间件就可以,不会对原有流程有影响 ### 调用流程 在执行控制器的方法前,会先执行下面方法来确定此方法是否注册有中间件,调用中间件进行处理 ``` php public function runActionMiddleware(string $action) { if ($this->middleware && isset($this->middleware[$action]) && is_array($this->middleware[$action])) { $this->app->get('middleware') ->import($this->middleware[$action]) ->dispatch(); } } ``` ### 中间件类定义 ``` php namespace middleware\index; use ank\Request; /** *搜索关键词过滤 */ class Search { public function handle(Request $request, \Closure $next, $name) { $request->testkey = 'testkey' . $name; // return \ank\Response::create([], 'json'); //执行下一个中间件 return $next(); } } ``` 处理后要返回 $next($request) 业务会将数据传递给其它中间件处理,如果返回的是Response实例则会直接响应客户端,handle的参数根据自己的需要可以传引用数据 ### 控制器中注册中间件 然后在控制器中添加middleware属性,数组里的键为当前控制器中方法的名字,一定要跟方法一至(区分大小写),如下所示在**index**操作方法被调用前会先执行中间件中的操作对请求进行过滤设置 ``` php namespace controller\index; use ank\App; /** * asdf */ class Index extends \ank\Controller { protected $middleware = [ 'index' => [ // 第一个为中间件类,第二个往后以次为要输入的参数 [\middleware\index\Search::class, 'nameasdfasf'], //没有参数就直接写类名 \middleware\index\Second::class, ], ]; public function index() { // echo input('testkey'); $app = App::getInstance(); $runtime = number_format(microtime(true) - $app->getStartTime(), 10); echo $runtime; die(); } } ```