yii伪静态在apache下失效的主因是三处未配齐:apache需启用mod_rewrite并设allowoverride all,urlmanager须同时配置enableprettyurl=>true、showscriptname=>false及非空rules,.htaccess必须含rewriteengine on及两条!-f/!-d条件和rewriterule . index.php。

Yii 伪静态在 Apache 下跑不起来,90% 是因为三处没配齐:PHP 层 urlManager 配置、Apache 模块与目录权限、项目根目录的 .htaccess 规则。少一个,404 就稳了。
Apache 必须启用 mod_rewrite 并放开 AllowOverride
Yii 的 urlManager 不做重写,只做路由解析;请求得先被 Apache 重写进 index.php,PHP 层才有机会处理。所以第一步不是改 PHP 配置,而是确认 Apache 能“放行”重写规则:
- 打开
httpd.conf,取消注释:LoadModule rewrite_module modules/mod_rewrite.so - 找到你项目的
<directory></directory>块(比如<directory></directory>),把AllowOverride None改成AllowOverride All - 如果用的是 XAMPP/MAMP/PhpStudy,还要确认主配置里没用
<ifmodule></ifmodule>把整个模块禁掉 - 改完必须重启 Apache,
phpinfo()里搜mod_rewrite确认已加载
Yii2 的 urlManager 三个关键配置项
在 config/web.php 的 components 里配 urlManager,光设 enablePrettyUrl => true 不够,下面三项缺一不可:
-
enablePrettyUrl必须为true—— 否则整个美化逻辑跳过,永远走index.php?r=xxx -
showScriptName必须为false—— 否则 URL 里始终带index.php,比如/index.php/site/index -
rules至少有一条兜底规则,例如'' => 'site/index'—— 否则访问根路径/直接 404
常见错误写法:'showScriptName' => 'false'(字符串 false ≠ 布尔 false)、rules 空数组、漏掉 enablePrettyUrl。
Apache Superset 是一个广泛采用的开源 BI 平台,用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时,此技能非常有用。
.htaccess 文件内容不能少这两行条件
文件必须放在与 index.php 同级的 web 根目录下,内容核心就三段,顺序不能乱:
RewriteEngine on
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . index.php
重点说明:
-
!-f和!-d缺一不可:跳过真实存在的文件(如css/app.css)和目录(如uploads/),只把“找不到对应文件/目录”的请求转给index.php -
RewriteRule . index.php里的点(.)表示“匹配任意非空字符串”,比^(.*)$更简洁安全;别写成index.php/$1或index.php?/$1,Yii2 不认这种格式 - 如果部署在子目录(如
http://example.com/myapp/),需加RewriteBase /myapp/
rules 顺序错会导致路由被吞,调试建议加 debug 路由
URL 规则按数组顺序从上到下匹配,命中即停。泛匹配(如 '<controller:>/<action:>'</action:></controller:>)放太前,会吃掉你后面定义的具体路由:
- 错误示例:
'<controller:>/' => '<controller>/index'</controller></controller:>放第一行 →/admin/login被当成controller=admin+action=login,根本进不了admin/login对应的 action - 正确做法:具体路由优先,比如先写
'admin/login' => 'admin/login',再写通配规则 - 调试技巧:临时加一条
'debug/test' => 'site/test',访问/debug/test看是否响应,比翻日志快得多
真正容易被忽略的是:Apache 配置改了但没重启,或者 .htaccess 文件编码是 UTF-8 with BOM(Windows 记事本默认),会导致 Rewrite 引擎静默失败——用 VS Code 或 Notepad++ 确认保存为纯 UTF-8 无 BOM。










