插件窝 干货文章 在ThinkPHP6中使用中间件处理请求

在ThinkPHP6中使用中间件处理请求

中间件 class 路由 优先级 683    来源:    2024-10-24

【引言】

ThinkPHP6是一个著名的PHP开源框架,它优雅的继承了前代版本的优秀特性,并集成了PHP7新特性,使得它更快,更安全。在ThinkPHP6中,中间件是非常重要的一部分,它允许开发者可以在请求前、请求中、请求后进行处理,以此来实现更加灵活和可扩展的应用。

【正文】

一、什么是中间件?

中间件是指在请求到达应用程序之前和之后可以执行的代码。中间件的存在使得应用程序可以被轻松地扩展和管理。

立即学习“PHP免费学习笔记(深入)”;

在ThinkPHP6中,中间件可以实现以下功能:

  1. 路由前置处理,如:验证token,拦截非法请求等
  2. 控制器方法前置处理,如:统计PV、UV;请求参数处理等
  3. 控制器方法后置处理,如:缓存响应数据,记录日志等
  4. 路由后置处理,如:响应问题等

二、中间件的使用

使用ThinkPHP6的中间件很简单,只需要在配置文件中进行中间件配置,即可按照指定顺序执行。

2.1 中间件的注册

在config/middleware.php文件中,可以看到以下默认中间件列表:

<?php

return [
    // 别名或分组
    'alias'    => [],
    // 优先级设置,此数组中的中间件会按照优先级进行先后排序
    'priority' => [],
    // 中间件列表
    'middleware' => [
            hinkmiddlewareSessionInit::class,
            hinkmiddlewareAllowCrossDomain::class,
    ],
];

其中,第一个中间件为SessionInit中间件,目的是初始化session,第二个中间件为AllowCrossDomain中间件,目的是允许跨域请求。如果你需要配置自己的中间件,则可以定义自己的中间件类,并在上述配置中添加即可。

2.2 中间件的排序

ThinkPHP6中的中间件可以按照优先级进行排序,优先级值越小,执行顺序越靠前。在中间件的配置文件中,可以针对指定分组或别名设置中间件的优先级,如下所示:

<?php

return [
    // 别名或分组
    'alias'    => [
        'home' => ppmiddlewareCheck::class,
    ],
    // 优先级设置,此数组中的中间件会按照优先级进行先后排序
    'priority' => [
        ppmiddlewareDemo::class => 1,
        ppmiddlewareTest::class => 2,
    ],
    // 中间件列表
    'middleware' => [
            hinkmiddlewareSessionInit::class,
            hinkmiddlewareAllowCrossDomain::class,
    ],
];

在上述配置中,将demo中间件设置为1号优先级,test中间件设置为2号优先级。

2.3 中间件的使用

在ThinkPHP6中,可以针对全局路由或分组路由使用中间件,也可以针对指定控制器或控制器方法使用中间件。

(1)全局路由使用中间件

在应用目录下的route/route.php文件中,可以注册全局路由,如下所示:

<?php

use thinkacadeRoute;

Route::get('hello/:name','index/hello')->middleware('Check');

在上述代码中,通过middleware('Check')添加了一个名为Check的中间件,表示在执行index/hello方法前先执行Check中间件。

(2)分组路由使用中间件

在应用目录下的route/group.php文件中,可以注册分组路由,如下所示:

<?php

use thinkacadeRoute;

//定义分组路由
Route::group('/api', function () {
    Route::get('/user/:id', 'api/user/read')->middleware('Check');
});

在上述代码中,定义了一个名为api的分组路由,其中/user/:id路由使用了名为Check的中间件。

(3)控制器级别使用中间件

在控制器文件中,可以通过特殊命名的方法来定义方法级别的中间件,如下所示:

<?php
namespace appcontroller;

class Test
{
    // 方法级别
    public function read() 
    {
        return "Hello Word!";
    }

    // 方法级别
    public function write()
    {
        return "Hello China!";
    }

    // 控制器级别
    protected $middleware = [ppmiddlewareCheck::class];

    // 方法级别
    protected $middleware = [
        'read' => [ppmiddlewareReadCheck::class],
        'write' => [ppmiddlewareWriteCheck::class],
    ];
}

在上述代码中,read和write方法使用了方法级别的中间件,Check中间件为控制器级别的中间件。

【总结】

中间件是一个强大的工具,它提供了非常灵活的请求处理方式,使得我们可以在请求前、请求中和请求后对数据进行处理。在ThinkPHP6中,使用中间件非常简单,只需要按照一定规则编写中间件类,并进行配置即可,有非常大的灵活性和可扩展性。