中间件提供了一种方便的机制来检查和过滤进入应用程序的 HTTP 请求。 例如，Lithe 包含检查用户是否经过身份验证的中间件。如果没有，中间件会将用户重定向到登录屏幕。如果用户通过身份验证，中间件将允许请求继续。

中间件如何在 Lithe 中工作

在 Lithe 中，中间件是能够访问请求对象 ($req)、响应对象 ($res) 和应用程序请求-响应周期中的 $next 函数的函数。 $next 函数在调用时会调用当前堆栈中的下一个中间件。

中间件函数提供了一种检查、过滤和操作应用程序传入 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 请求在到达应用程序之前经过的一系列“层”。每层都可以检查或拒绝请求。

加载中间件

要加载中间件，请调用 \Lithe\App 类的 use() 方法，并指定中间件函数。例如：

$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!');
});

每当应用程序收到请求时，都会打印消息“LOGGED”。中间件加载的顺序很重要：先加载的先执行。

myLogger 中间件只是打印一条消息，然后使用 $next() 将请求传递给下一个中间件。

使用中间件

灵活的应用程序可以使用以下类型的中间件：

• 应用级中间件
• 路由器级中间件
• 第三方中间件

应用层中间件

您可以使用 use() 或 METHOD() 方法将应用程序级中间件附加到应用程序的实例，其中 METHOD 指小写的 HTTP 方法（例如 GET、PUT、POST）。

此示例显示没有路径的中间件。每次收到请求时中间件都会运行：

$app->use(function ($req, $res, $next) {
    echo 'Hello World!';
    $next();
});

在下面的示例中，中间件处理对路径 /user/:id:
的 GET 请求

$app->get('/user/:id', function ($req, $res, $next) {
    if ($req->param('id') === '0') {
        return $next();
    } 
    $res->send('ID is not 0');
}, function ($req, $res) {
    $res->send('regular');
});

路由器级中间件

路由器级中间件的工作方式类似于应用程序级中间件，但附加到 \Lithe\Http\Router 的实例：

$router = new \Lithe\Http\Router;

您可以使用 use() 和 METHOD() 函数加载路由器级中间件。

下面是路由器级中间件的示例：

$router = new \Lithe\Http\Router;

$router->use(function ($req, $res, $next) {
    echo 'Time: ', Date('H:i:s'), '
';
    $next();
});

$router->get('/user/:id', function ($req, $res, $next) {
    if ($req->param('id') === '0') {
        $res->redirect('/');
    }
    $next();
}, function ($req, $res) {
    echo $req->param('id');
    $res->render('special');
});

$app->use('/api', $router);

第三方中间件

您可以使用第三方中间件向您的 Lithe 应用程序添加功能。安装所需的 PHP 模块，然后在应用程序或路由器级别加载它。

下面是使用 \Lithe\Middleware\Session\session 加载会话中间件的示例：

use function Lithe\Middleware\Session\session;

$app = new \Lithe\App;

$app->use(session([
    'secure' => true
]));

有关 Lithe 常用的第三方中间件列表，请查看第三方中间件资源。

可配置中间件

如果您需要可配置中间件，您可以创建一个接受选项数组或其他参数的函数，然后根据这些参数返回中间件实现。请参阅下面的示例：

现在，您可以使用具有自定义配置的中间件：



$app->use(my_middleware(['option1' => '1', 'option2' => '2']));




要创建其他开发人员可以通过 Composer 安装的中间件，有一个名为 lithemod/flow 的包。它提供了用于在 Lithe 中处理 HTTP 请求和响应的接口和实用程序，这有助于跨各种应用程序创建标准化且随时可用的中间件。

lithemod/flow 通过为请求和响应提供统一的接口来帮助构建强大的中间件，使开发更加高效和有组织。这简化了中间件与其他项目的集成，并确保代码遵循一致的标准。