phpEnv下Apache必须启用mod_rewrite模块才能实现URL重写,否则.htaccess规则无效;需取消httpd.conf中LoadModule rewrite_module注释、设置AllowOverride All、正确放置.htaccess并配置框架URL_MODEL为2或3。

phpEnv 下 Apache 必须启用 mod_rewrite 才能隐藏 index.php
phpEnv 是 Windows 下的 PHP 集成环境,它默认不启用 mod_rewrite 模块,所以即使你写了 .htaccess 规则,也会完全无效——浏览器直接 500 或 404,日志里可能只报 Invalid command 'RewriteEngine'。
实操步骤:
- 打开 phpEnv 安装目录下的
Apache/conf/httpd.conf - 找到这行:
#LoadModule rewrite_module modules/mod_rewrite.so,删掉开头的# - 再找
<directory></directory>(路径以你实际 www 目录为准),确认其内部有:AllowOverride All或至少AllowOverride FileInfo Options;若仍是AllowOverride None,必须改掉 - 保存后,在 phpEnv 控制面板中「重启 Apache」,不是仅刷新页面
.htaccess 规则要严格匹配 phpEnv 的 Apache 版本和路径结构
phpEnv 多数基于较新 Apache(2.4+),但部分旧版包仍用 2.2 语法,RewriteCond 判断逻辑稍有不同。最稳妥的规则是:
<IfModule mod_rewrite.c>
Options +FollowSymlinks -Multiviews
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L]
</IfModule>
注意点:
立即学习“PHP免费学习笔记(深入)”;
-
Options +FollowSymlinks必须加上,否则 Apache 2.4+ 会拒绝加载 .htaccess 中的重写规则 - 不要用
^/(.*)$开头——phpEnv 的 DocumentRoot 是相对路径,加斜杠反而导致匹配失败 - 末尾的
[QSA,PT,L]缺一不可:QSA保留原查询参数,PT让 Apache 把重写结果交给 PHP 处理器,L终止后续规则
ThinkPHP 等框架的 URL_MODEL 必须设为 2 或 3
很多用户配好了 Apache 和 .htaccess,但访问 /user/login 仍 404,问题往往出在框架配置上。
以 ThinkPHP 为例:
- 检查
config/app.php或app/config.php中是否设置了'url_model' => 2(PATHINFO 模式)或3(兼容模式) - 绝对不能是
0(普通模式)或1(QUERY_STRING 模式),否则框架根本不解析 PATHINFO 路径 - 若使用
.env,确认没被APP_URL_MODEL=1这类环境变量覆盖(ThinkPHP 会优先读.env) - 修改后清空
runtime/下所有缓存,否则旧路由规则仍在内存中生效
phpEnv 的「网站根目录」和「项目入口目录」容易混淆
phpEnv 的「网站管理」里添加站点时,填的是整个域名的 DocumentRoot(比如 D:/phpEnv/www),但你的 PHP 项目往往放在子目录下(如 D:/phpEnv/www/myapp)。这时 .htaccess 必须放在 myapp 目录里,而不是 www 根目录。
常见错误现象:
- 放错位置:把
.htaccess放在www目录,结果整个 phpEnv 下所有站点都受影响 - 路径硬编码:规则里写死了
/myapp/index.php,但 Apache 的DocumentRoot并不包含/myapp,导致重写后路径错乱 - Windows 文件权限:phpEnv 默认以当前 Windows 用户身份运行 Apache,但若你用管理员权限解压项目,
.htaccess可能被系统标记为“受保护”,Apache 读不到——建议右键属性 → 「安全」→ 确保 Users 组有「读取」权限
真正起作用的,永远是 Apache 实际服务该请求时所用的 DocumentRoot 对应的那个 .htaccess 文件,而不是你「觉得应该放那里」的位置。



















