在构建现代 Web 应用时，路由扮演着至关重要的角色，它负责将用户请求映射到相应的处理程序。手动编写和维护路由规则既耗时又容易出错。league/route 是一个基于 FastRoute 构建的快速路由和分发组件，它提供了简洁、高效的路由解决方案，并且完美支持 PSR-15 中间件。通过 league/route，我们可以轻松地定义路由规则，并将其与相应的控制器或处理程序关联起来，从而简化 Web 应用的开发过程。 composer在线学习地址：学习地址
首先，我们需要使用 composer 安装 league/route：
composer require league/route
安装完成后，就可以开始使用 league/route 了。下面是一个简单的示例，展示了如何定义一个路由规则，并将其与一个控制器方法关联起来：
<?php use LeagueRouteRouteCollection; use LeagueRoutehttpException as HttpException; use LaminasDiactorosServerRequestFactory; use LaminasDiactorosResponseFactory; use LaminasHttpHandlerRunnerEmitterSapiEmitter; // 1. 创建路由收集器实例 $route = new RouteCollection( new ResponseFactory() ); // 2. 定义路由规则 $route->map('GET', '/users/{id:number}', 'AppControllerUserController::getUser'); // 3. 添加中间件（可选） $route->middleware(new AppMiddlewareAuthMiddleware()); // 4. 路由分发 try { $request = ServerRequestFactory::fromGlobals($_SERVER, $_GET, $_POST, $_COOKIE, $_FILES); $response = $route->dispatch($request); } catch (HttpException $e) { // 处理 HTTP 异常 $response = (new ResponseFactory())->createResponse($e->getStatusCode()); $response->getBody()->write($e->getMessage()); } catch (Throwable $e) { // 处理其他异常 $response = (new ResponseFactory())->createResponse(500); $response->getBody()->write('Internal Server Error'); } // 5. 发送响应 (new SapiEmitter())->emit($response);
在这个示例中，我们首先创建了一个 RouteCollection 实例，用于收集路由规则。然后，使用 map() 方法定义了一个 GET 请求的路由规则，将 /users/{id:number} 映射到 AppControllerUserController::getUser 方法。{id:number} 表示一个名为 id 的参数，并且必须是数字类型。
league/route 还支持中间件，可以在路由分发之前或之后执行一些操作，例如身份验证、日志记录等。使用 middleware() 方法可以添加中间件。
最后，使用 dispatch() 方法进行路由分发，将请求传递给相应的处理程序。如果发生 HTTP 异常，例如 404 Not Found，可以通过 HttpException 捕获并处理。
立即学习“PHP免费学习笔记（深入）”；
league/route 的优势在于其简洁的 API 和强大的功能。它支持多种路由规则，包括静态路由、动态路由、可选参数、正则表达式约束等。同时，它还提供了灵活的中间件机制，可以方便地扩展路由的功能。
通过使用 league/route，我们可以将路由规则集中管理，提高代码的可读性和可维护性。此外，league/route 基于 FastRoute 构建，具有出色的性能，可以满足高并发 Web 应用的需求。
总之，league/route 是一款优秀的 PHP 路由组件，它可以帮助我们轻松实现路由管理，提升开发效率。如果你正在寻找一款简洁、高效的路由解决方案，那么 league/route 绝对值得尝试。
