在 Yii2 中需通过 UrlManager 的 rules 数组配置 UrlRule 实现带参 URL 别名，必须设置 enablePrettyUrl=true、showScriptName=false，规则 key 为路径模板、value 为路由字符串，参数用 语法提取，多参数时路径仅含结构化参数，查询参数自动附加。
怎么在 Yii2 里用 UrlRule 实现带参数的 URL 别名
Yii2 的路由别名不是靠改 .htaccess 或 Nginx 配置，而是通过 UrlManager 的 rules 数组定义 UrlRule 对象来实现。核心是把「请求路径」和「内部路由」双向绑定，同时支持参数提取。
常见错误是只写了一半：比如写了 'post/<id:>' => 'post/view'</id:>，但没配 ['class' => 'yii\web\UrlRule', ...]，结果 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，关掉它就等于关掉路由日志，排查效率断崖下降
复杂规则往往卡在正则边界或顺序上，日志比猜快十倍。别跳过这一步。
