Webman路由优化技巧_Webman大规模路由分组管理【建议】-php教程-PHP中文网

应使用 route::group() 替代多个 route::any()，因其支持统一前缀、方法约束、中间件及默认路由映射，提升可维护性与安全性；webman 1.4+ 默认路由机制可自动解析 /api/{控制器}/{动作} 到对应控制器方法。

webman路由优化技巧_webman大规模路由分组管理【建议】

Webman 里大量同控制器的路由，别一个个 Route::any() 硬写，直接用路由分组 + 默认路由规则就能省掉 80% 的配置代码。

为什么 `Route::group()` 比一堆 `Route::any()` 更合适

你当前写的三行：Route::any('/test', [...]); Route::any('/test2', [...]); Route::any('/test3', [...]);，本质是把同一个控制器下的方法“平铺”注册，既难维护、又无法共享前缀和中间件，还容易漏加 POST/GET 限制。

而 Route::group() 允许你一次性声明路径前缀、HTTP 方法约束、中间件，并把控制器方法映射逻辑收口到默认路由机制里——这才是 Webman 原生支持的高效方式。

默认路由规则（{控制器}/{动作}）在 Webman 1.4+ 已稳定支持，且与 Route::group() 完全兼容
路由分组本身不增加运行时开销，FastRoute 编译后仍是单次匹配
中间件、命名空间、参数约束等可统一设置，避免重复粘贴

用 `Route::group()` 绑定整个控制器目录

假设你的 app\api\controller\AggregationController 类里有 test、test2、test3 三个 public 方法，想通过 /api/test、/api/test2 这类路径访问，推荐这样写：

use Webman\Route;
Route::group('/api', function () {
    // 启用默认控制器路由：/api/{控制器}/{动作} → 自动映射到 app\api\controller\{控制器}Controller::action
    Route::any('/{controller}/{action}', [app\api\controller\IndexController::class, 'fallback'])
        ->name('api.default')
        ->middleware(['app\middleware\ApiAuth::class']);
});

但更干净的做法是直接利用 Webman 的默认路由机制，删掉所有单条路由，只保留分组前缀，并确保控制器路径符合约定：

Skill Weave Chains — 技能链路由引擎

开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。

下载

把 AggregationController 放在 app/api/controller/ 目录下
访问 /api/aggregation/test 就会自动调用 app\api\controller\AggregationController::test()
如果坚持用 /api/test 这种扁平路径，需额外定义 fallback 路由或改写控制器命名（如命名为 TestController）