首页  >  文章  >  后端开发  >  Lithe 中的中间件:它是如何工作的以及如何创建自己的中间件

Lithe 中的中间件:它是如何工作的以及如何创建自己的中间件

DDD
DDD原创
2024-10-25 03:28:29419浏览

Middleware in Lithe: How It Works and How to Create Your Own

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


加载中间件

要加载中间件,请调用 LitheApp 类的 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() 将请求传递给下一个中间件。


使用中间件

Lithe 应用程序可以使用以下类型的中间件:

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

应用层中间件

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

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

$app->use(function ($req, $res, $next) {
    $next();
});

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

$myLogger = function ($req, $res, $next) {
  echo 'LOGGED';
  $next();
};

路由器级中间件

路由器级中间件的工作方式类似于应用程序级中间件,但附加到 LitheHttpRouter 的实例:

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

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

这是路由器级中间件的示例:

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

第三方中间件

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

这是使用 LitheMiddlewareSessionsession 加载会话中间件的示例:

$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 常用的第三方中间件列表,请查看第三方中间件资源。


可配置中间件

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

$router = new \Lithe\Http\Router;

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

$router = new \Lithe\Http\Router;

$router->use(function ($req, $res, $next) {
    echo 'Time: ', Date('H:i:s'), '<br>';
    $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);

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

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

以上是Lithe 中的中间件:它是如何工作的以及如何创建自己的中间件的详细内容。更多信息请关注PHP中文网其他相关文章!

声明:
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn