Yii框架Apache伪静态设置教程

Yii框架在Apache下实现伪静态常因三处配置未同步到位而失败：Apache需启用mod_rewrite模块并设置AllowOverride All以允许.htaccess生效；PHP层urlManager必须同时开启enablePrettyUrl、关闭showScriptName，并配置非空rules；项目根目录的.htaccess则须严格包含RewriteEngine on及两条关键条件（跳过真实文件和目录）与正确的RewriteRule。任一环节遗漏或配置错误（如布尔值写成字符串、BOM编码、规则顺序混乱、未重启服务等）都会导致404，本文直击90%失效场景的核心痛点，提供可立即验证的完整排错路径。

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
• 找到你项目的 块（比如 ），把 AllowOverride None 改成 AllowOverride All
• 如果用的是 XAMPP/MAMP/PhpStudy，还要确认主配置里没用 把整个模块禁掉
• 改完必须重启 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。

.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 规则按数组顺序从上到下匹配，命中即停。泛匹配（如 '/'）放太前，会吃掉你后面定义的具体路由：

• 错误示例：'/' => '/index' 放第一行 → /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。

今天关于《Yii框架Apache伪静态设置教程》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！