确认mod_rewrite已启用需先查看phpinfo()输出中是否存在该模块,若无则需在WAMP/MAMP/XAMPP中启用;即使启用,还需确保httpd.conf中对应Directory的AllowOverride设置为All并重启Apache。

Apache本地环境怎么确认mod_rewrite已启用
大多数PHP本地环境(如XAMPP、WAMP、MAMP)默认编译了mod_rewrite,但模块未必处于启用状态。直接访问.htaccess文件或使用RewriteRule会返回500 Internal Server Error或404,往往就是这个原因。
验证方式很简单:在项目根目录新建一个info.php,写入
mod_rewrite。如果没出现,说明模块未启用。
- Windows下WAMP:点击系统托盘图标 →
Apache→Modules→ 勾选rewrite_module -
macOS下MAMP:偏好设置 →
Apache→ 勾选Load Apache Module: rewrite_module - XAMPP:编辑
apache/conf/httpd.conf,确保这行未被注释:LoadModule rewrite_module modules/mod_rewrite.so
为什么修改了httpd.conf还是不生效
即使mod_rewrite已加载,.htaccess仍可能被忽略——根本原因是AllowOverride配置限制了重写权限。
找到Apache主配置中对应网站目录的块(常见路径如DocumentRoot所在目录),确认其中包含:
立即学习“PHP免费学习笔记(深入)”;
AllowOverride All Require all granted
注意:AllowOverride None会彻底禁用.htaccess;AllowOverride FileInfo仅允许部分指令(包括Rewrite*),但保险起见建议用All。改完必须重启Apache。
如何写一个最简可用的.htaccess重写规则
本地测试时,避免复杂正则,先用最基础的路径映射验证是否走通。
例如把/test重写为/index.php?route=test,.htaccess内容应为:
RewriteEngine On
RewriteBase /
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php?route=$1 [QSA,L]
-
RewriteEngine On是开关,缺了整个文件无效 -
RewriteBase /在本地子目录部署时要改成对应路径(如/myapp/) - 两个
RewriteCond防止真实存在的文件或目录被错误重写 -
[QSA,L]中QSA保留原始查询参数,L表示“最后一条”,避免后续规则干扰
PHP内置服务器不支持.htaccess怎么办
如果你用的是php -S localhost:8000这种内置服务器,它完全无视.htaccess和mod_rewrite——这是PHP设计使然,不是配置问题。
此时有两种选择:
- 换回Apache或Nginx本地环境(推荐用于真实开发)
- 用PHP脚本模拟路由:启动命令改为
php -S localhost:8000 router.php,并在router.php中手动解析$_SERVER['REQUEST_URI'],转发到对应逻辑
后者适合快速原型,但无法复现生产环境的重写行为,上线前务必在Apache/Nginx下再验证一次。











