Yii2 提供了 GroupUrlRule 组件，可通过其 prefix 属性为整组 URL 规则的匹配路径（即规则键名）自动添加统一前缀，避免重复书写如 api/ 等前缀，大幅提升路由配置的可维护性与扩展性。
yii2 提供了 groupurlrule 组件，可通过其 `prefix` 属性为整组 url 规则的匹配路径（即规则键名）自动添加统一前缀，避免重复书写如 `api/` 等前缀，大幅提升路由配置的可维护性与扩展性。
在大型 Yii2 应用中，常需将某类接口（如 API）统一挂载到特定路径下（例如 /api/v1/xxx），若手动为每条 URL 规则都添加 'api/<controller>/<action>' => 'v1/<controller>/<action>' 这类键值对，不仅冗余易错，更难以后期统一调整前缀（如从 api 升级为 api/v2）。此时，yii\web\GroupUrlRule 是官方推荐且最优雅的解决方案。
GroupUrlRule 允许你将一组规则逻辑分组，并通过 prefix 属性自动为该组内所有规则的 pattern（即左侧键名）注入指定前缀——这正是问题中所要求的“为所有 keys 添加 prefix”，而非仅作用于路由值（route）的 $prefixRoute。
✅ 正确用法示例
'urlManager' => [
'enablePrettyUrl' => true,
'showScriptName' => false,
'rules' => [
// 其他非 API 规则（如前台页面）
'' => 'site/index',
'<controller>/<action>' => '<controller>/<action>',
// 使用 GroupUrlRule 统一管理 API 路由
new \yii\web\GroupUrlRule([
'prefix' => 'api', // ? 所有子规则的 pattern 自动加上 'api/' 前缀
'rules' => [
'' => '_public/site/index', // 匹配 /api → route: _public/site/index
'<controller>/<action>' => '_public/<controller>/<action>',
'<controller:\w+>/<id:\d+>' => '_public/<controller>/view',
// 可继续添加数十甚至数百条规则，无需重复写 'api/'
],
]),
// 若需支持版本化（如 /api/v2/...），只需修改 prefix 即可：
// 'prefix' => 'api/v2',
],
],? 关键机制说明：GroupUrlRule 会将 'prefix' => 'api' 与子规则中的 pattern 字符串进行拼接。例如子规则 '<controller>/<action>' 将实际匹配 api/<controller>/<action>；空字符串 '' 则精确匹配 api 路径本身。
⚠️ 注意事项
- 根路径匹配需显式定义：'' => '...' 在组内表示匹配 prefix 本身（即 /api），而非 /api/ 后加斜杠。若需兼容末尾斜杠，建议配合 suffix 配置或使用正则规则。
- 规则顺序很重要：GroupUrlRule 是一个规则对象，与其他普通规则并列。若存在同级冲突规则（如 'api/<controller>' => ...），应确保 GroupUrlRule 的位置合理（通常建议置于具体规则之后、通配规则之前）。
- 不适用于 .htaccess：虽然 Apache 的 RewriteRule 可做路径重写，但它发生在 Web 服务器层，无法影响 Yii 的路由解析逻辑，也无法实现「规则键名自动补全」这一框架级需求。URL 重写仅用于兼容旧链接或 SEO，不应替代 GroupUrlRule 的语义化分组功能。
- 性能无损耗：GroupUrlRule 在应用启动时完成规则预编译，运行时匹配效率与普通规则一致，适合高并发场景。
✅ 总结
GroupUrlRule 是 Yii2 路由系统中专为解决「批量路径前缀管理」而设计的核心组件。它让数百条 API 规则共享同一入口路径变得简洁、安全且易于演进。相比硬编码、字符串拼接或外部重写方案，它是唯一符合框架设计哲学、具备类型安全与可维护性的标准实践。在构建 RESTful API 或微服务网关层时，应作为路由配置的默认范式优先采用。
