传统路由的困境：为什么我们需要异步？
想象一下，您正在开发一个需要处理高并发请求的 API 服务。在传统的 php FPM 模式下，每个请求都会占用一个独立的 PHP 进程，并且在处理 I/O 操作（比如查询数据库、调用第三方服务）时，这个进程会一直阻塞，直到 I/O 完成才能继续执行。当并发量一大，所有进程都可能被阻塞，导致新的请求只能排队等待，响应时间直线飙升，用户体验急剧下降。
这种“一请求一进程，阻塞等待”的模式，在面对现代互联网服务对高并发、低延迟的要求时，显得力不从心。我们渴望一种能够让 PHP 在等待 I/O 时也能处理其他请求的机制，也就是——异步编程。
拥抱异步：AMPHP 与高性能路由的结合
AMPHP 是 PHP 世界中一套强大的事件驱动库集合，它利用 PHP 8.1+ 的 Fibers（协程）特性，让 PHP 代码能够以同步的写法实现异步的执行效果，极大地提升了处理并发 I/O 的能力。当您使用 amphp/http-server 构建异步 HTTP 服务器时，一个高效的路由解决方案就显得尤为重要。
这时，amphp/http-server-router 应运而生。它专门为 amphp/http-server 设计，提供了一个基于 HTTP 方法和路径的路由 RequestHandler。它整合了 FastRoute 库的强大功能，能够以极高的效率将传入的请求分发到对应的处理程序，是构建高性能异步 Web 服务的理想选择。
立即学习“PHP免费学习笔记（深入）”；
composer 让一切变得简单
使用 amphp/http-server-router 非常简单，只需通过 Composer 即可轻松安装：
<code class="bash">composer require amphp/http-server-router amphp/http-server</code>
这条命令不仅安装了路由库，还一并安装了 amphp/http-server，确保您的异步服务器环境搭建完整。Composer 负责管理所有依赖，让您无需担心版本冲突或手动加载的问题。
amphp/http-server-router 的核心功能与实践
amphp/http-server-router 的核心是一个实现了 RequestHandler 接口的 Router 类。这意味着它可以直接作为 HttpServer 的请求处理程序。
1. 定义路由
最基本的功能就是通过 addRoute($method, $uri, $requestHandler) 方法来定义路由。
<pre class="brush:php;toolbar:false;">use AmpHttpServerRouter; use AmpHttpServerRequestHandlerClosureRequestHandler; use AmpHttpServerResponse; use AmpHttpHttpStatus; // ... 初始化 $server, $logger, $errorHandler ... $router = new Router($server, $logger, $errorHandler); // 定义一个 GET 请求到根路径的路由 $router->addRoute('GET', '/', new ClosureRequestHandler( function () { return new Response( status: HttpStatus::OK, headers: ['content-type' => 'text/plain'], body: 'Hello, world!', ); }, )); // 定义一个带参数的 GET 请求路由 $router->addRoute('GET', '/user/{name}', new ClosureRequestHandler( function (Request $request) { // 从请求属性中获取路由参数 $args = $request->getAttribute(Router::class); return new Response( status: HttpStatus::OK, headers: ['content-type' => 'text/plain'], body: "Hello, {$args['name']}!", ); }, ));
这里的 {name} 是 FastRoute 风格的占位符，匹配到的值会作为属性存储在请求中，方便您在 RequestHandler 中获取。
2. 中间件（Middleware）
中间件是处理请求的强大工具，可以在请求到达最终处理程序之前或之后执行一些通用逻辑，例如身份验证、日志记录、数据解析等。
Router 允许您通过 addMiddleware($middleware) 方法添加全局中间件：
<pre class="brush:php;toolbar:false;">use AmpHttpServerMiddlewareCompressionMiddleware; use AmpHttpServerMiddlewaresessionMiddleware; $router->addMiddleware(new CompressionMiddleware()); // 压缩响应 $router->addMiddleware(new SessionMiddleware()); // 处理会话
注意： 如果您需要为特定路由添加中间件，而不是所有路由，可以使用 AmpHttpServerMiddlewarestackMiddleware() 函数来包装您的 RequestHandler。
3. 优雅的错误处理与回退（Fallback）
当没有路由匹配请求路径时，Router 会默认返回一个 404 响应。但您可以通过 setFallback($requestHandler) 方法指定一个自定义的 RequestHandler 来处理所有未匹配的路由，实现更灵活的错误页面或默认行为。
<pre class="brush:php;toolbar:false;">use AmpHttpServerResponse; use AmpHttpHttpStatus; $router->setFallback(new ClosureRequestHandler( function () { return new Response( status: HttpStatus::NOT_FOUND, headers: ['content-type' => 'text/plain'], body: '404 - Not Found!', ); }, ));
重要提示： 通过 addMiddleware() 添加的全局中间件不会作用于回退处理程序。如果回退处理程序也需要中间件，请使用 stackMiddleware() 显式包装它。
实际应用效果与优势
通过 amphp/http-server-router，我们能够：
- 提升性能与吞吐量： 利用 AMPHP 的异步特性，服务器在等待 I/O 时不会阻塞，能够同时处理更多的请求，显著提升服务的响应速度和吞吐量。FastRoute 的集成也保证了路由匹配的极高效率。
- 简化复杂路由逻辑： 清晰的
addRoute接口，结合占位符和正则表达式，让路由定义变得直观且强大。 - 增强代码可维护性： 中间件机制使得通用逻辑（如认证、日志）与业务逻辑分离，代码结构更清晰，易于维护和扩展。
- 构建现代化的 Web 服务： 拥抱异步编程范式，让 PHP 应用在性能和并发能力上与 node.js 等其他异步平台一较高下，非常适合构建微服务、API 网关或实时应用。
总结
amphp/http-server-router 结合 Composer 的便捷性，为 PHP 开发者提供了一个构建高性能异步 Web 服务的强大工具。它解决了传统 PHP 阻塞式路由在并发场景下的痛点，通过直观的 API、高效的路由匹配和灵活的中间件机制，帮助我们轻松构建出响应迅速、可扩展且易于维护的现代 PHP 应用。如果您正致力于提升 PHP 应用的性能和并发能力，那么 amphp/http-server-router 绝对值得一试！