Yii2美化URL怎么设置-YII-PHP中文网

必须同时配置Web服务器和Yii2的urlManager，缺一不可；Web服务器需将美化URL（如/article/123）转发至index.php，Apache用.htaccess启用mod_rewrite并设置AllowOverride All，Nginx用try_files $uri $uri/ /index.php?$args且确保$document_root指向web/目录；Yii2中需同时设enablePrettyUrl=>true和showScriptName=>false，并配置有效rules。

yii2美化url怎么设置

必须同时改 Web 服务器配置和 Yii2 的 urlManager，缺一不可。只配框架或只配服务器，都会 404。

Web 服务器转发请求到 index.php

美化后的 URL（比如 /article/123）不对应真实文件，得让 Apache 或 Nginx 把所有非静态资源请求都转给 index.php 处理。

Apache：确认 mod_rewrite 已启用，在项目 web/ 目录下放 .htaccess，内容至少包含：

RewriteEngine on
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . index.php

Nginx：在 location / 块里用 try_files，别用过时的 if (!-e $request_filename)：
```
location / {
    try_files $uri $uri/ /index.php?$args;
}
```
注意 $document_root 要正确指向 web/ 目录，否则 SCRIPT_FILENAME 会错。
常见错误：Nginx 配置里漏掉 ?$args，导致 GET 参数（如 ?page=2）丢失；Apache 下 .htaccess 权限被禁（AllowOverride None），规则根本不执行。

Yii2 urlManager 基础配置

urlManager 必须显式启用美化，并关闭入口脚本名显示，否则所有自定义规则都不生效。

在 config/web.php 或 config/main.php 的 components 里加：

'urlManager' => [
    'enablePrettyUrl' => true,
    'showScriptName' => false,
    'rules' => [],
],

'enablePrettyUrl' => true 和 'showScriptName' => false 必须同时为 true，少一个，Url::to(['site/about']) 就还是输出 /index.php?r=site%2Fabout。
如果想加伪后缀（如 /article/123.html），加 'suffix' => '.html' 即可，但注意静态资源（.css、.js）也会被匹配，需在 Web 服务器规则里确保它们优先被真实文件响应。

写可匹配又可生成的路由规则

规则 key 是请求路径模板，value 是目标路由字符串；要让 Url::to() 正常工作，不能把 value 写成数组。

Yii Framework 2.0.51

Yii Framework 2.0.51 官方 Basic 应用模板，适合旧项目兼容、升级验证和开发测试。

下载

基础写法：'article/' => 'article/view'，访问 /article/123 会进 ArticleController::actionView()，且 Url::to(['article/view', 'id' => 123]) 会生成 /article/123。
参数正则必须明确：比更安全，后者默认匹配 [^/]+，容易误匹配斜杠或空值。
顺序很重要：泛化规则（如 '/' => '/'）必须放在具体规则之后，否则 /article/123 会被前面那条先吃掉，永远匹配不到你的 article/。
别漏掉 class 声明：如果要用正则、默认值等高级功能，得显式指定 ['class' => 'yii\web\UrlRule']，否则 Yii 默认用简单字符串匹配，不起作用。

调试时最该看的三个地方

URL 美化失败，90% 的问题出在这三处，而不是规则本身写得有多复杂。

检查 urlManager 是否真的加载了：在控制器里 var_dump(\Yii::$app->urlManager->enablePrettyUrl);，不是 true 就白配。
用 curl -I http://yourdomain/article/123 看返回状态码，如果是 404 且没进 index.php，说明 Web 服务器转发没生效；如果是 200 但内容不对，才查框架路由。
开启 enableStrictParsing（临时）：'enableStrictParsing' => true，能让不匹配任何规则的请求直接报 404，避免被 fallback 规则静默吞掉，方便定位漏匹配。

真正麻烦的从来不是怎么写规则，而是 Web 服务器和框架两层之间谁没接上信号——转发没通、配置没载入、顺序被颠倒，这些点不盯死，再漂亮的规则也跑不起来。