Yii2 提供 GroupUrlRule 类，可通过其 prefix 属性为整组路由规则的匹配路径（即规则键）自动添加统一前缀，避免重复书写如 'api/...'，大幅提升大型项目路由配置的可维护性与可读性。
yii2 提供 `groupurlrule` 类，可通过其 `prefix` 属性为整组路由规则的匹配路径（即规则键）自动添加统一前缀，避免重复书写如 `'api/...'`，大幅提升大型项目路由配置的可维护性与可读性。
在 Yii2 应用中，当需要为大量 API 路由统一添加 /api 前缀（例如 /api/user/index、/api/post/view）时，若手动在每条规则键中重复写 'api/...'，不仅冗余易错，更难以后期统一调整——尤其当规则达数百条时，维护成本极高。
此时，yii\web\GroupUrlRule 是官方推荐且最优雅的解决方案。它允许你将一组相关路由封装为一个“路由组”，并通过 prefix 属性自动为该组内所有规则的匹配模式（即规则数组的键） 添加指定前缀，而无需修改规则值（即路由目标）。
✅ 正确用法示例
在 config/web.php 的 urlManager 配置中，使用 GroupUrlRule：
'urlManager' => [
'enablePrettyUrl' => true,
'showScriptName' => false,
'rules' => [
// 其他非 API 规则（如首页、后台等）
'' => 'site/index',
// 将所有 API 路由归入一个带 prefix 的组
new \yii\web\GroupUrlRule([
'prefix' => 'api',
'rules' => [
'' => '_public/site/index', // 匹配 /api
'<controller:\w+>' => '_public/<controller>/index',
'<controller:\w+>/<action:\w+>' => '_public/<controller>/<action>',
'<controller:\w+>/<id:\d+>' => '_public/<controller>/view',
// 可继续添加数十甚至上百条规则，全部自动拥有 /api/ 前缀
],
]),
// 其他独立规则（如管理后台）
'admin/<controller>/<action>' => 'admin/<controller>/<action>',
],
],? 关键说明：
- prefix => 'api' 作用于所有子规则的键：'' → /api，'<controller>...' → /api/<controller>/...；
- 子规则中的空字符串 '' 会精确匹配 /api 路径（注意不是 /api/，若需支持尾部斜杠，可配合 suffix 或正则增强）；
- GroupUrlRule 是完全内置、无额外依赖的 Yii2 核心组件，兼容 RESTful 配置与自定义参数解析。
⚠️ 注意事项
- 顺序敏感：GroupUrlRule 实例应置于通用通配规则（如 '<controller>/<action>'）之前，否则可能被提前匹配，导致分组失效；
- 不支持嵌套分组：当前 Yii2 版本（2.0.x）暂不支持 GroupUrlRule 内再嵌套 GroupUrlRule，但单层分组已足够覆盖绝大多数场景；
- 勿混淆 $prefixRoute：$prefixRoute（属于 UrlRule）用于为路由值（右侧目标）添加前缀（如自动补 _public/），而本文解决的是匹配路径（左侧键）的前缀问题，二者用途截然不同；
- .htaccess 不适用：重写规则（如 Apache 的 .htaccess）仅处理 HTTP 请求路径到脚本的映射（如 index.php），无法干预 Yii2 内部的路由解析逻辑，因此不能替代 GroupUrlRule 实现“键前缀”功能。
✅ 总结
使用 GroupUrlRule 是 Yii2 中实现路由键批量前缀的标准、高效、可扩展方案。它将重复逻辑上提至分组层级，显著提升配置清晰度与长期可维护性。对于中大型项目，建议将 API、移动端、管理端等不同域的路由分别组织为独立 GroupUrlRule，形成结构化、语义明确的路由体系。
