Yii2的路由怎么自定义_实现URL规则别名及参数传递【技巧】

在 yii2 中需通过 UrlManager 的 rules 数组配置 UrlRule 实现带参 URL 别名，必须设置 enablePrettyUrl=true、showScriptName=false，规则 key 为路径模板、value 为路由字符串，参数用 <param:d+> 语法提取，多参数时路径仅含结构化参数，查询参数自动附加。

怎么在 Yii2 里用 UrlRule 实现带参数的 URL 别名

Yii2 的路由别名不是靠改 .htaccess 或 nginx 配置，而是通过 UrlManager 的 rules 数组定义 UrlRule 对象来实现。核心是把「请求路径」和「内部路由」双向绑定，同时支持参数提取。

常见错误是只写了一半：比如写了 'post/<id:>' => 'post/view'</id:>，但没配 ['class' => 'yiiwebUrlRule', ...]，结果 URL 生成正常，但访问时 404 —— 因为默认规则不启用正则匹配，必须显式声明 UrlRule 类型。

• 必须把自定义规则放进 'urlManager' => ['rules' => [...]]，不能只写在 components 里不挂载
• 路径中用 <pattern></pattern> 语法提取参数，pattern 是正则（如 d+、[a-z-]+），不写 pattern 默认匹配任意非斜杠字符
• 如果想让 Url::to(['post/view', 'id' => 123]) 自动变成 /post/123，规则 key 必须是路径模板，value 必须是目标路由字符串（不能是数组）

为什么 createUrl() 不走你写的 UrlRule

最常踩的坑：规则写了，Url::to() 却还是输出 /index.php?r=post%2Fview&id=123。根本原因是规则没有被匹配上——可能因为顺序错、模式太窄、或没启用 enablePrettyUrl。

检查点很具体：

• 'enablePrettyUrl' => true 和 'showScriptName' => false 必须同时设，否则所有规则都不生效
• 规则数组顺序很重要：Yii2 从上到下匹配，更具体的规则（如带 <id:></id:>）要放在泛化规则（如 '<action>' => 'site/<action>'</action></action>）前面
• 如果 value 是数组（如 ['route' => 'post/view', 'defaults' => ['status' => 'draft']] ），那这个规则只用于解析请求，不参与 URL 生成 —— 生成时会跳过它

如何传递多个参数并保持 URL 干净

Yii2 的 UrlRule 支持多段参数，但写法容易出错。比如想把 /user/john/posts?page=2 映射到 user/post/index 并提取 username 和 page，不能只靠路径占位符。

正确做法是路径部分只放必须的、有结构意义的参数（如用户名），查询参数（page、sort）保留为 GET 参数，由框架自动附加：

['pattern' => 'user/<username:[a-z0-9-]+>/posts', 'route' => 'user/post/index']

这样 Url::to(['user/post/index', 'username' => 'john', 'page' => 2]) 就会生成 /user/john/posts?page=2 —— 路径由规则控制，查询参数自动拼接，不需要也不应该塞进 pattern 里。

• 避免写 'user/<username>/posts?<page>'</page></username> 这类伪 pattern，UrlRule 不解析问号后内容
• 如果真需要把 page 做成路径段（如 /user/john/posts/2），pattern 得写成 'user/<username>/posts/<page:>'</page:></username>，且 controller action 必须接收 $page 参数
• 所有命名参数（<username></username>、<page></page>）最终都会作为 GET 参数传给目标 action，无需手动 $_GET 取

调试 UrlRule 匹配失败的最快方法

当访问一个 URL 却进不了预期的 action，别急着翻文档。直接看 Yii::getLogger()->flush(); 日志没用，得用 Yii2 内置的路由调试开关。

在入口文件 web/index.php 顶部加一行：

defined('YII_DEBUG') or define('YII_DEBUG', true);

然后访问任意 URL，在页面底部会看到「Application Log」区域，展开「Route Matching」条目，就能看到每条规则是否匹配、匹配了哪些参数、为什么某条规则被跳过。

• 日志里出现 Rule does not match 说明 pattern 完全不匹配；出现 Rule matched but route mismatch 说明路径对了但目标路由名不对
• 如果连「Route Matching」都没出现，大概率是 enablePrettyUrl 没开，或者 web 服务器没正确转发（Nginx 缺 try_files $uri $uri/ /index.php?$args;）
• 开发期建议始终开着 YII_DEBUG，关掉它就等于关掉路由日志，排查效率断崖下降

复杂规则往往卡在正则边界或顺序上，日志比猜快十倍。别跳过这一步。