Apache如何配置PHP的URL重写_使用mod_rewrite与PHP协作的指南【详解】

启用mod_rewrite前必须确认三件事：一是模块已启用（sudo a2enmod rewrite或取消httpd.conf中loadmodule注释），二是allowoverride all（或fileinfo）已配置，三是.htaccess文件存在且apache用户有读取权限。

Apache启用mod_rewrite模块前必须确认的三件事

php本身不处理URL重写，真正起作用的是Apache的mod_rewrite模块——它在请求到达PHP之前就完成路径改写。如果你发现.htaccess里的规则没生效，大概率不是PHP配置问题，而是mod_rewrite没启用或AllowOverride被禁用。

• 运行sudo a2enmod rewrite（debian/ubuntu）或确认LoadModule rewrite_module modules/mod_rewrite.so在httpd.conf中已取消注释（centos/RHEL）
• 确保对应虚拟主机或目录配置里包含AllowOverride All（仅AllowOverride FileInfo也够用，但All更省心）
• .htaccess文件必须放在Web根目录或子目录下，且Apache用户（如www-data或apache）有读取权限

PHP项目常用重写规则：隐藏index.php与支持PATH_INFO

现代PHP框架（laravel、thinkphp、CodeIgniter等）依赖将所有请求路由到index.php，再由PHP解析$_SERVER['REQUEST_URI']分发。关键不是“让PHP能重写”，而是“让Apache把非静态资源全交给PHP处理”。

RewriteEngine On RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule ^(.*)$ index.php/$1 [L]

注意：index.php/$1这种写法会触发PATH_INFO，PHP中可通过$_SERVER['PATH_INFO']获取原始路径；若用index.php?_url=/$1，则需从$_GET['_url']读取——两种方式都可行，但前者更轻量，后者兼容性略高（尤其在某些FastCGI配置下）。

• 务必保留两个RewriteCond：跳过真实存在的文件（如css/style.css）和目录，否则静态资源会404
• [L]标志表示“最后一条规则”，避免后续规则干扰；如果还有其他重写逻辑，需谨慎安排顺序
• 若使用PHP-FPM，确认fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;未被意外覆盖，否则index.php可能无法执行

重写后PHP如何安全获取原始请求路径

重写会改变$_SERVER中多个变量的值，直接读$_SERVER['REQUEST_URI']通常仍正确，但$_SERVER['SCRIPT_NAME']和$_SERVER['PATH_INFO']取决于重写写法和SAPI模式。别假设它们一定可靠。

立即学习“PHP免费学习笔记（深入）”；

• 最稳妥的方式是用$_SERVER['REQUEST_URI']（含查询参数）配合parse_url()提取路径部分
• 如果用了index.php/$1写法，且PATH_INFO可用，可检查isset($_SERVER['PATH_INFO']) && $_SERVER['PATH_INFO'] !== ''，但需确认php.ini中cgi.fix_pathinfo=1（默认值，但某些docker镜像会关掉）
• 避免依赖$_SERVER['REDIRECT_URL']：它是Apache内部变量，不同版本行为不一致，且CLI或某些FastCGI环境可能不存在

调试mod_rewrite失败时最先查的三个地方

重写不生效时，90%的问题出在Apache配置层，而不是PHP代码。不要一上来就改PHP路由逻辑。

• 查看Apache错误日志：tail -f /var/log/apache2/Error.log（Ubuntu）或/var/log/httpd/error_log（CentOS），搜索rewrite或htaccess关键词，常能看到Options FollowSymLinks or SymLinksIfOwnerMatch is off这类提示
• 临时在.htaccess顶部加RewriteRule ^test-rewrite$ /test.php [R=302,L]，访问/test-rewrite看是否跳转，快速验证模块和AllowOverride是否真生效
• 用curl -I http://localhost/.htaccess确认该文件不能被直接下载（应返回403），否则说明AllowOverride未生效或Files指令被绕过

重写是Apache的事，PHP只是接收结果；把边界划清楚，排查效率会高很多。PATH_INFO是否开启、REQUEST_URI是否被代理篡改、mod_rewrite日志级别是否调为RewriteLogLevel 3（仅开发环境）——这些细节比写一百行PHP路由更影响最终效果。