解决PHP路由与业务逻辑耦合：使用Composer和middlewares/request-handler构建清晰应用架构

在构建复杂的PHP Web应用时，你是否曾遇到这样的困扰：路由配置中定义的控制器方法或匿名函数，不仅要负责处理请求，还要兼顾参数验证、用户认证、权限检查等一系列前置工作？久而久之，这些路由回调变得臃肿不堪，难以阅读，更别提维护和测试了。每当你需要修改某个业务逻辑，都可能不小心触碰到其他不相关的代码，引发意想不到的副作用。这种路由与业务逻辑的高度耦合，就像一个盘根错节的藤蔓，让你的项目变得越来越难以驾驭。

这正是许多开发者在追求“干净架构”和“单一职责原则”时面临的实际问题。我们渴望一种机制，能够将“请求来了，去哪里？”（路由）和“到了目的地，该做什么？”（业务逻辑处理）这两个核心步骤清晰地分开，并在它们之间插入各种“守卫”或“前置条件”。

幸运的是，随着PSR-7（HTTP消息接口）和PSR-15（HTTP服务器请求处理程序）标准的普及，PHP社区为我们提供了一套优雅的解决方案——中间件（Middleware）。而 middlewares/request-handler 这个 Composer 包，正是这套解决方案中的一颗璀璨明珠，它专门用于解决路由发现与请求处理之间的衔接问题。

Composer 助力，引入 middlewares/request-handler

要使用 middlewares/request-handler，首先你需要通过 Composer 将其引入到你的项目中。Composer 是 PHP 的一个依赖管理工具，它能让你轻松地安装和管理项目所需的各种库。

立即学习“PHP免费学习笔记（深入）”；

<code class="bash">composer require middlewares/request-handler</code>

这条简单的命令，就会将 middlewares/request-handler 及其所有依赖项下载到你的项目中，并自动配置好自动加载，让你能够立即开始使用。

middlewares/request-handler：解耦路由与处理的核心

middlewares/request-handler 的核心思想很简单：它是一个特殊的中间件，其职责是执行由上游路由中间件发现的请求处理程序。这意味着，你的路由中间件（例如 middlewares/fast-route 或 middlewares/aura-router）负责解析请求URL，并确定哪个控制器或处理程序应该响应这个请求，然后将这个处理程序的引用作为请求的一个属性传递下去。而 middlewares/request-handler 做的，就是从请求中取出这个引用，并实际调用它。

这样做的好处是显而易见的：

AppMall应用商店

AI应用商店，提供即时交付、按需付费的人工智能应用服务

56

查看详情

1. 清晰的职责分离： 路由中间件只管路由，request-handler 只管执行，其他中间件则专注于它们各自的横切关注点（如认证、日志、限流等）。
2. 灵活的中间件链： 你可以在路由中间件和 request-handler 之间插入任意数量的其他中间件。例如，先进行用户认证，再检查权限，最后才执行业务逻辑。如果任何一个前置中间件发现问题（比如用户未登录），它可以直接返回一个响应，阻止后续的业务逻辑执行，从而避免不必要的资源消耗。
3. 支持多种处理程序类型： request-handler 非常灵活，它能处理多种类型的处理程序：
   • 字符串： 如果是类名字符串，它会尝试通过 PSR-11 容器实例化该类。
   • 可调用对象 (callable)： 匿名函数或包含 __invoke 方法的对象。
   • 实现 MiddlewareInterface 或 RequestHandlerInterface 的对象： 这是最符合 PSR 规范的方式。
4. 易于集成 PSR-11 容器： 对于字符串形式的控制器，你可以传入一个 PSR-11 容器，让它负责实例化控制器，从而轻松实现依赖注入。

实际应用：构建一个清晰的请求处理流程

让我们通过一个简单的例子，看看 middlewares/request-handler 如何与路由中间件一起工作。这里我们以 middlewares/fast-route 为例：

<pre class="brush:php;toolbar:false;"><?php

require 'vendor/autoload.php';

use FastRoute\simpleDispatcher;
use FastRoute\RouteCollector;
use Middlewares\FastRoute;
use Middlewares\RequestHandler;
use Middlewares\Utils\Dispatcher;
use Psr\Http\Message\ServerRequestInterface;
use Psr\Http\Message\ResponseInterface;
use GuzzleHttp\Psr7\ServerRequest;
use GuzzleHttp\Psr7\Response;

// 假设我们有一个简单的控制器
class HelloWorldController
{
    public function __invoke(ServerRequestInterface $request, ResponseInterface $response): ResponseInterface
    {
        $name = $request->getAttribute('name', 'World');
        $response->getBody()->write("Hello, {$name}!");
        return $response->withHeader('Content-Type', 'text/plain');
    }
}

// 1. 定义路由规则
$fastRouteDispatcher = simpleDispatcher(function (RouteCollector $r) {
    $r->get('/hello/{name}', HelloWorldController::class);
    $r->get('/greet', function (ServerRequestInterface $request, ResponseInterface $response): ResponseInterface {
        $response->getBody()->write('Greetings!');
        return $response->withHeader('Content-Type', 'text/plain');
    });
});

// 2. 创建一个中间件调度器
$dispatcher = new Dispatcher([
    // 第1层中间件：路由解析。它会根据请求找到匹配的路由，
    // 并将处理程序（HelloWorldController::class 或匿名函数）
    // 放入请求的 'request-handler' 属性中。
    new FastRoute($fastRouteDispatcher),

    // ... 在这里可以插入其他中间件，例如认证、日志、CORS等 ...
    // new AuthMiddleware(),
    // new LogMiddleware(),

    // 第2层中间件：请求处理。它会从请求中取出 'request-handler' 属性，并执行它。
    new RequestHandler(),
]);

// 3. 模拟一个服务器请求
$request = new ServerRequest('GET', '/hello/Alice');
// $request = new ServerRequest('GET', '/greet');
// $request = new ServerRequest('GET', '/non-existent'); // 模拟一个不存在的路由

// 4. 调度请求并获取响应
$response = $dispatcher->dispatch($request);

// 5. 输出响应
echo $response->getStatusCode() . ' ' . $response->getReasonPhrase() . "\n";
echo $response->getHeaderLine('Content-Type') . "\n";
echo $response->getBody();

在这个例子中：

• FastRoute 中间件负责解析 /hello/Alice 这个 URL，并识别出 HelloWorldController::class 是它的处理程序。
• 它会将 HelloWorldController::class 这个字符串存储在 ServerRequest 对象的 request-handler 属性中。
• RequestHandler 中间件接着从请求中获取这个 request-handler 属性，并根据其类型（这里是类名字符串）实例化 HelloWorldController，然后调用它的 __invoke 方法来生成响应。

你还可以通过 handlerAttribute() 方法自定义存储处理程序的请求属性名，或者通过 continueOnEmpty() 方法改变当处理程序属性为空时的行为（默认会抛出异常）。

总结与展望

middlewares/request-handler 配合 Composer 及其生态系统，为我们提供了一种构建高度解耦、可扩展且易于测试的 PHP 应用的强大方式。它使得：

• 业务逻辑更纯粹： 你的控制器或处理程序可以专注于业务逻辑本身，无需关心路由匹配或前置条件的检查。
• 架构更清晰： 整个请求处理流程一目了然，每个中间件各司其职。
• 开发效率更高： 通过复用标准化的中间件，可以大大减少重复代码的编写。

如果你正在寻找一种现代、高效的方式来组织你的 PHP 应用架构，那么 middlewares/request-handler 绝对值得你尝试。它将帮助你摆脱代码的泥潭，拥抱一个更加优雅、灵活的开发体验。

以上就是解决PHP路由与业务逻辑耦合：使用Composer和middlewares/request-handler构建清晰应用架构的详细内容，更多请关注php中文网其它相关文章！