中间件提供了一种方便的机制来检查和过滤进入应用程序的 HTTP 请求。例如,Lithe 包含用于检查应用程序用户是否经过身份验证的中间件。如果用户未经过身份验证,中间件会将用户重定向到应用程序的登录屏幕。但是,如果用户经过身份验证,中间件将允许请求在应用程序内继续进行。
在 Lithe 中,中间件是可以访问应用程序请求响应循环中的请求对象 ($req)、响应对象 ($res) 和 $next 函数的函数。 $next 函数是 Lithe 路由器中的一个函数,调用时会执行当前中间件旁边的中间件。
中间件函数提供了一种方便的机制来检查、过滤和处理进入应用程序的 HTTP 请求。
中间件函数可以执行以下任务:
如果当前中间件函数没有结束请求-响应周期,则必须调用 $next() 将控制权传递给下一个中间件函数。否则,请求将被等待处理。
以下代码显示了中间件函数调用的元素:
$app->use(function ($req, $res, $next) { $next(); });
地点:
- $req:中间件函数的 HTTP 请求参数,按照惯例称为“$req”。
- $res:中间件函数的 HTTP 响应参数,按照惯例称为“$res”。
- $next:中间件函数的回调参数,按照惯例称为“$next”。
让我们从一个名为 myLogger 的简单中间件示例开始。每次请求通过该中间件时,该中间件都会打印 LOGGED 消息。中间件被定义为分配给名为 myLogger 的变量的函数:
$myLogger = function ($req, $res, $next) { echo 'LOGGED'; $next(); };
注意上面对 $next() 的调用。调用此函数会调用应用程序中的下一个中间件函数。 $next() 函数不是 PHP 或 Lithe 的一部分,但它是传递给中间件函数的第三个参数。 $next() 函数可以有任何名称,但按照惯例,它始终称为“next”。为了避免混淆,请始终使用此约定。
最好将中间件视为 HTTP 请求在到达应用程序之前必须遍历的一系列“层”。每一层都可以检查请求,甚至完全拒绝它。
要加载中间件函数,您可以调用 LitheApp 类的 use() 方法,并指定所需的中间件函数。例如,以下代码在执行到根路径(/)的路由之前加载 myLogger 中间件函数:
$app->use(function ($req, $res, $next) { $next(); });
每当应用程序收到请求时,它都会打印消息“LOGGED”。
中间件加载顺序很重要:先加载的中间件函数也会先执行。
myLogger 中间件函数只是打印一条消息,然后通过调用 $next() 函数将请求传递给堆栈上的下一个中间件函数。
Lithe 应用程序可以使用以下类型的中间件:
使用 use() 和 METHOD() 方法将应用程序级中间件绑定到应用程序对象的实例,其中 METHOD 是中间件函数处理的请求的 HTTP 方法(例如 GET、PUT 或 POST)小写。
此示例显示了一个没有汇编路径的中间件函数。每次应用程序收到请求时都会执行该函数。
$myLogger = function ($req, $res, $next) { echo 'LOGGED'; $next(); };
下面的示例显示了一个处理路径 /user/:id 中的 GET 请求的中间件。
$app = new \Lithe\App; $myLogger = function ($req, $res, $next) { echo 'LOGGED'; $next(); }; $app->use($myLogger); $app->get('/', function ($req, $res, $next) { $res->send('Hello World!'); });
路由器级中间件的工作方式与应用程序级中间件相同,只是它绑定到 LitheHttpRouter 的实例。
$app->use(function ($req, $res, $next) { echo 'Hello World!'; $next(); });
使用 USE 和 METHOD 函数加载路由器级中间件。
以下示例代码展示了使用路由器级中间件的中间件系统:
$app->get('/user/:id', function ($req, $res, $next) { // Se o ID do usuário for '0', passa para o próximo middleware if ($req->param('id') === '0') { return $next(); } // Caso contrário, envia uma resposta específica $res->send('ID não é 0'); }, function ($req, $res) { // Envia uma resposta quando o ID for '0' $res->send('regular'); });
使用第三方中间件向 Lithe 应用添加功能。
安装所需功能所需的 PHP 模块,然后在应用程序级别或路由器级别将其加载到您的应用程序中。
以下示例说明了加载会话中间件,即 LitheMiddlewareSessionsession 函数。
$router = new \Lithe\Http\Router;
Lithe 常用的第三方中间件功能的部分列表,请参阅:第三方中间件。
如果您需要可配置的中间件,请创建一个接受选项数组或其他参数的函数,然后根据输入参数返回中间件实现。
$app->use(function ($req, $res, $next) { $next(); });
现在可以使用中间件了,如下所示。
$myLogger = function ($req, $res, $next) { echo 'LOGGED'; $next(); };
以上是Lithe 中的中间件:它是如何工作的以及如何创建自己的中间件的详细内容。更多信息请关注PHP中文网其他相关文章!