Nginx伪静态在Yii中只将非真实文件/目录请求兜底至index.php处理；必须同时配置Nginx的try_files规则和PHP层urlManager的enablePrettyUrl、showScriptName、rules三项，缺一则404或URL仍含index.php。
直接上结论：Nginx 伪静态在 Yii 中只做一件事——把非真实文件/目录的请求，全部兜给 index.php 处理；urlManager 配置和 Nginx 规则必须同时到位，缺一不可，否则必然 404。
Yii 的 urlManager 必须配这三项
光改 Nginx 没用，PHP 层不认规则，URL 还是带 index.php?r=xxx。以下三处必须显式设置（通常在 config/web.php 的 components['urlManager'] 下）：
-
enablePrettyUrl设为true—— 否则整个美化逻辑不启动 -
showScriptName设为false—— 否则生成的 URL 里永远挂着index.php -
rules至少有一条兜底规则，例如'' => 'site/index'—— 否则根路径/直接 404
常见错误：本地开发时页面全 404，或部分路由正常但 URL 始终含 index.php，大概率是 showScriptName 没设成 false，或 rules 为空/没加载。
Nginx 的 try_files 规则不能抄 Apache 的 .htaccess
Apache 用 RewriteRule，Nginx 用 try_files，语法和语义完全不同。直接把 Apache 的重写规则粘贴进宝塔「伪静态」框，基本等于白配。
正确写法（放在站点的 location / 块内）：
location / {
try_files $uri $uri/ /index.php?$args;
}
注意点：
- 别加
if (!-e $request_filename)—— Nginx 官方明确反对在location里用if，容易引发 404 或无限重定向 - 别漏掉
$args（即$query_string）—— 否则 GET 参数如?id=123会丢失 - 确保
root指向的是/web目录（如/www/wwwroot/myapp/web），不是项目根目录
宝塔面板里选「Laravel5」模板是最快捷方案
宝塔自带的伪静态模板里，「Laravel5」和 Yii2 的路由兜底逻辑一致，比手动填规则更可靠，尤其适合新手或快速部署场景。
操作路径：网站 → 你的站点 → 设置 → 伪静态 → 选择「Laravel5」→ 保存。
它等价于自动注入以下 Nginx 配置：
location / {
try_files $uri $uri/ /index.php?$query_string;
}
如果你后续要加 API 路由或静态资源排除（比如让 .js 文件直出不走 PHP），再手动微调；但初始阶段，直接选这个模板能避开 90% 的配置错位问题。
权限和路径错误常被当成「伪静态失败」
很多所谓「伪静态不生效」，实际是 Nginx 根本没读到 index.php，或者 PHP 加载配置时路径错了。
典型表现：
- 访问首页报
500 Internal Server Error，日志里出现Failed opening required '/www/wwwroot/myapp/requirements.php'—— 说明 Nginx 的root指向了项目根目录，而不是/web子目录 - 访问任何 URL 都返回 403 或 404，且 Nginx error log 显示
directory index of "/www/wwwroot/myapp/web/" is forbidden—— 说明index.php不在index列表里，或文件不可读 -
runtime和web/assets目录被宝塔重置权限后无法写入，导致路由缓存或资源发布失败，间接影响 URL 解析稳定性
最稳妥的做法：确认 root 是 /web 路径，index 包含 index.php，且 web/index.php 文件存在、可读、属主为 www。
