hyperf 2.x 路由配置需查阅三处:1. 官方存档文档(2.2 中文版路由章)涵盖定义方式、动态参数、中间件绑定及注解路由;2. 骨架项目 config/routes.php 文件含典型示例;3. 使用 php bin/hyperf.php route:list 命令验证路由注册与解析。

1. 官方文档(存档版)
访问 Hyperf 2.2 中文文档 → 路由章节。这是最权威的来源,涵盖:
– 路由定义方式(Router::get()、addRoute()、addGroup())
– 动态参数写法(如 /user/{id:\d+})
– 中间件绑定语法(['middleware' => [AuthMiddleware::class]])
– 注解路由启用条件与 @Controller/@GetMapping 示例
2. 骨架项目中的 routes.php
Hyperf 2.x 默认骨架(如 hyperf-skeleton v2.2.*)自带 config/routes.php 文件,打开即见清晰注释和典型用法,例如:
– 单方法路由:Router::get('/health', 'App\Controller\HealthController::index');
– 多方法路由:Router::addRoute(['GET', 'HEAD'], '/', ...);
– 分组路由:Router::group(['prefix' => '/api'], function () { ... });
3. CLI 命令辅助验证
运行以下命令可实时查看已加载的路由,是调试配置是否生效的最快方式:php bin/hyperf.php route:list
输出包含 Method、URI、Handler 三列,能直接确认路径是否注册、控制器是否解析正确、中间件是否挂载成功。











