apache url重写失败主因是mod_rewrite模块未启用和allowoverride未设为all,二者缺一不可且须按序配置:先启用模块(a2enmod或取消httpd.conf中#注释),再修改对应directory块的allowoverride为all,最后重启apache。

Apache 的 URL 重写不是 PHP 配置问题,而是 Apache 模块和目录权限的组合配置——缺一不可,且顺序不能错。
mod_rewrite 模块是否已启用?
PHP 本身不参与 URL 重写,mod_rewrite 是 Apache 的原生模块,必须显式启用。光在 .htaccess 里写 RewriteEngine On 没用,模块没加载时这条指令直接被忽略,连错误都不报。
- Debian/Ubuntu 系统:运行
sudo a2enmod rewrite,然后sudo systemctl restart apache2 - CentOS/RHEL 或手动安装 Apache:打开
httpd.conf,确认LoadModule rewrite_module modules/mod_rewrite.so这一行**没有 # 号**,保存后sudo systemctl restart httpd - 验证方式:访问
phpinfo()页面,Ctrl+F 搜mod_rewrite,出现在 “Loaded Modules” 列表中才算成功
AllowOverride All 是否生效?
.htaccess 文件只有在 Apache 明确允许时才会被读取。默认配置是 AllowOverride None,此时无论你怎么改 .htaccess,规则全无效。
- 找到对应站点的
<directory></directory>块(常见路径如/var/www/html或C:/xampp/htdocs) - 把
AllowOverride None改成AllowOverride All(或至少AllowOverride FileInfo,但All更少出错) - 注意:如果用了虚拟主机,
<virtualhost></virtualhost>内的<directory></directory>也要单独配,AllowOverride不继承 - 改完必须重启 Apache,
.htaccess修改不用重启,但权限配置改了就得重启
常见 .htaccess 规则写法与陷阱
最常用的是“前端控制器”模式(Laravel、ThinkPHP 等依赖的),但写错一个字符就 500 或 404。
- 基础写法(推荐 PATH_INFO 方式):
RewriteEngine On RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule ^(.*)$ index.php/$1 [L]其中!-f和!-d是关键——跳过真实存在的文件和目录,否则css/style.css也会被转到index.php/css/style.css导致 404 - 如果用
index.php?_url=方式,要加[QSA]标志保留原有查询参数:RewriteRule ^(.*)$ index.php?_url=/$1 [QSA,L] - Windows 下建
.htaccess文件容易失败:不要用记事本直接“另存为 .htaccess”,会丢扩展名;建议用命令行rename htaccess.txt .htaccess或 FTP 软件重命名 - 规则里开头的
^和结尾的$很重要,漏掉可能导致部分路径匹配失败或过度匹配
为什么重写后 $_SERVER 变量不准?
重写会干扰 $_SERVER['SCRIPT_NAME']、$_SERVER['PATH_INFO'] 的值,尤其在 FastCGI / PHP-FPM 环境下,不同 SAPI 行为不一致。
- 最稳妥获取原始请求路径的方式是:
parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH) - 不要依赖
$_SERVER['PATH_INFO'],除非你明确确认了AcceptPathInfo On且 PHP 运行模式支持 - 如果用了
index.php/$1写法,但$_SERVER['PATH_INFO']为空,大概率是 Apache 配置里漏了AcceptPathInfo On,或 PHP-FPM 的fastcgi_param PATH_INFO $fastcgi_path_info;没配对
真正卡住人的从来不是规则语法,而是模块没启、权限没放、路径没对上这三处——检查时按这个顺序来,90% 的问题当场解决。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











