XAMPP Apache重写规则配置教程

本文详解XAMPP环境下Apache重写规则（mod_rewrite）配置的完整避坑指南，直击新手高频故障：从LoadModule语法错误、重复声明导致启动失败，到AllowOverride位置错配使.htaccess失效，再到RewriteEngine遗漏、RewriteBase缺失引发路由错乱，以及UTF-8 BOM编码、日志调试等隐蔽陷阱——每一步都附带精准定位方法和可立即验证的操作指令，助你快速打通本地开发环境的URL重写链路。

确认 mod_rewrite 模块已加载且未被重复声明

Apache 启动失败或报 Invalid module name，大概率是 LoadModule rewrite_module modules/mod_rewrite.so 这行写错了。XAMPP 默认带这个模块，但默认被注释；手动添加时容易多写一个 .so（比如写成 rewrite_module.so），或复制粘贴出两个相同 LoadModule 行——Apache 会拒绝启动。

操作建议：

• 打开 C:\xampp\apache\conf\httpd.conf（Windows）或对应路径
• 搜索 rewrite_module，只保留**唯一一行**未注释的：LoadModule rewrite_module modules/mod_rewrite.so
• 注意：模块名不含扩展名，.so 是文件后缀，不是模块名一部分
• 改完后，在命令行执行 httpd -t 验证语法，返回 Syntax OK 才继续

AllowOverride 必须设为 All，且位置要对

即使模块加载成功，.htaccess 里的 RewriteEngine On 依然无效，说明 Apache 拒绝读取该文件——根本原因是 AllowOverride None 还在生效。

常见陷阱：

• 全局 块里改了 AllowOverride All，但你项目实际放在 htdocs/myapp，而虚拟主机配置里又套了一层 ，里面仍是 None，那外层设置就白改
• 用了 却把 AllowOverride All 写在外部 里，规则不会继承过去
• 路径大小写错误（Windows 不敏感，但某些配置解析器会卡住）

验证方法：在 htdocs 下放一个仅含 garbage_text 的 .htaccess，访问任意页面。若返回 500，说明文件被读取；若无反应，AllowOverride 仍为 None。

重写规则必须显式开启引擎并注意 RewriteBase

RewriteEngine On 不是可选的默认行为，漏写就会整个 .htaccess 重写逻辑静默失效，浏览器只显示 404 或原始 PHP 路径。

如果你的项目不在 htdocs 根目录（例如在 htdocs/blog），而规则里用 ^test$ 匹配，Apache 实际匹配的是完整 URI 路径（即 /blog/test），此时不加 RewriteBase /blog/，$1 捕获和跳转路径都会错位。

典型结构示例（放在 htdocs/blog/.htaccess）：

RewriteEngine On
RewriteBase /blog/
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php?route=$1 [L,QSA]

注意：[QSA] 保留原查询参数，[L] 防止后续规则干扰，这两项在 Laravel、CodeIgniter 等框架中几乎是标配。

调试必须看 error.log，别信浏览器 500 页面

浏览器只告诉你“服务器内部错误”，真正线索全在日志里。XAMPP 的 Apache 错误日志路径是 C:\xampp\apache\logs\error.log（Windows），打开后搜索关键词：rewrite、htaccess、Invalid command 'RewriteEngine'。

高频线索解读：

• Invalid command 'RewriteEngine' → 模块没加载，或 LoadModule 行有语法错误
• Request exceeded the limit of 10 internal redirects → 规则形成死循环，检查 RewriteCond 是否漏掉 !-f/!-d 判断
• File does not exist: C:/xampp/htdocs/test → 规则没生效，请求直接落到物理路径，说明 RewriteEngine 未开启或 AllowOverride 未生效

最后提醒：Windows 下 .htaccess 文件名必须是纯 .htaccess（无任何后缀），编码必须是 UTF-8 无 BOM；用记事本另存为时选“ANSI”或“UTF-8（无签名）”，否则 Apache 会因不可见字符报错。

到这里，我们也就讲完了《XAMPP Apache重写规则配置教程》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于XAMPP的知识点！