必须同时配置 Yii 的 urlManager 和 Web 服务器，否则 showScriptName => false 无效；因该配置仅控制 URL 生成时不显示 index.php，而 Web 服务器需将 /article/123 等请求转发至 index.php 处理，否则直接 404。
必须同时配置 Yii 的 urlManager 和 Web 服务器（Nginx/Apache），否则 showScriptName => false 无效，index.php 一定会暴露在 URL 中。
为什么 showScriptName => false 单独设置没用
这个配置只是告诉 Yii “生成 URL 时别写 index.php”，但浏览器发起请求时，如果服务器没把 /article/123 这类路径转发给 index.php 处理，就会直接返回 404。本质是前后端协同问题：Yii 负责“生成”，服务器负责“接收并路由”。
-
enablePrettyUrl => true是开关，不启用则所有规则不生效 -
showScriptName => false只影响Url::to()等生成函数的输出，不影响请求分发 - Web 服务器配置缺失时，访问
/site/login会报 404，而非跳转到index.php?r=site/login
Nginx 隐藏 index.php 的最小可靠配置
别套用网上五花八门的 try_files 组合，以下配置经 2026 年主流 Nginx 版本（1.22+）验证可用，且兼容 PHP-FPM socket 模式：
location / {
try_files $uri $uri/ /index.php?$query_string;
}
- 必须用
$query_string（不是$args），否则带参数的美化 URL 如/articles/1.html?sort=date会丢参 - 不能写成
try_files $uri $uri//index.php?$args—— 多余斜杠会导致 404 - 若项目部署在子目录（如
/myapp/），需额外加alias或重写前缀，location /本身不处理子目录
Apache 的 .htaccess 关键点
常见错误是只复制 RewriteRule，却忽略权限和模块检查：
- 确认
mod_rewrite已启用：a2enmod rewrite+ 重启 Apache -
AllowOverride All必须在虚拟主机或目录配置中显式开启，否则.htaccess被忽略 - 标准
.htaccess内容（放在web/目录下）：
RewriteEngine on
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php [L]
- 注意：这里没拼接
$1或QSA，因为 Yii 自动从$_SERVER['REQUEST_URI']解析 pathinfo，强行带参反而干扰路由 - 若使用 PHP CGI 模式，可能需要添加
RewriteBase /
urlManager 配置里最容易被忽略的细节
很多人以为配完 rules 就万事大吉，其实三个布尔值的组合直接影响行为边界：
-
'suffix' => '.html'启用后，所有匹配规则的 URL 必须带.html后缀，否则 404；同时Url::to(['article/view', 'id' => 123])会自动补上.html -
'enableStrictParsing' => true开启后，未定义在rules中的 URL（如直接访问/admin但没配该规则）将拒绝响应，而不是 fallback 到默认路由 -
'cache' => '@runtime/urlManagerCache.php'建议开启，尤其在高并发场景，避免每次请求都解析正则
真实线上环境出问题，八成卡在 Web 服务器转发环节，而不是 Yii 配置本身。先 curl 测试 curl -I http://yoursite/article/123 看是否返回 200 或 404，再决定查哪一层。
