phpEnv Apache Rewrite模块开启与规则编写指南

一分耕耘，一分收获！既然打开了这篇文章《phpEnv Apache Rewrite模块开启与规则编写指南》，就坚持看下去吧！文中内容包含等等知识点...希望你能在阅读本文后，能真真实实学到知识或者帮你解决心中的疑惑，也欢迎大佬或者新人朋友们多留言评论，多给建议！谢谢！

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，规则全无效。

• 找到对应站点的 块（常见路径如 /var/www/html 或 C:/xampp/htdocs）
• 把 AllowOverride None 改成 AllowOverride All（或至少 AllowOverride FileInfo，但 All 更少出错）
• 注意：如果用了虚拟主机， 内的 也要单独配，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% 的问题当场解决。

本篇关于《phpEnv Apache Rewrite模块开启与规则编写指南》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！