Apache与PHP-FPM环境下SCRIPT_NAME差异的配置解决方法问询

在Debian 12的Apache+PHP-FPM环境中，使用mod_rewrite实现友好URL时，$_SERVER['SCRIPT_NAME']与mod_php环境的差异本质是运行模式的参数传递逻辑不同：mod_php作为Apache模块直接获取执行脚本的路径，而PHP-FPM作为独立的FastCGI服务，依赖Apache传递的参数来确定SCRIPT_NAME。当重写规则将请求转向index.php时，若Apache未正确传递参数，PHP-FPM会将原始请求路径（如/heading/article）设为SCRIPT_NAME，而非实际执行的/index.php。

以下是正规的配置解决方法：

方法一：调整重写规则与FastCGI匹配规则 #

1. 修改mod_rewrite规则，传递PATH_INFO #

将原有SEF重写规则调整为：

RewriteEngine On
# 排除静态文件与目录
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
# 将请求路径作为PATH_INFO传递给index.php
RewriteRule ^(.*)$ index.php/$1 [L]

2. 调整Apache的PHP-FPM代理配置 #

确保ProxyPassMatch规则能正确匹配带PATH_INFO的请求，将实际脚本路径传递给PHP-FPM：

# 匹配index.php及后续的PATH_INFO部分
ProxyPassMatch ^/(index\.php)(.*)$ fcgi://127.0.0.1:9000/var/www/html/$1$2

此配置会让PHP-FPM将SCRIPT_NAME设为/index.php，PATH_INFO设为/heading/article，与mod_php环境的行为完全一致。

方法二：通过Apache环境变量强制设置SCRIPT_NAME #

若无法修改重写规则，可在Apache虚拟主机配置中通过SetEnvIf强制指定SCRIPT_NAME：

<Location "/">
    # 对所有非静态请求，设置SCRIPT_NAME为/index.php
    SetEnvIf Request_URI "^/(?!.*\.(css|js|png|jpg|gif)$)" SCRIPT_NAME="/index.php"
    # 代理到index.php
    ProxyPass fcgi://127.0.0.1:9000/var/www/html/index.php
    ProxyPassReverse fcgi://127.0.0.1:9000/var/www/html/index.php
</Location>

注意需保留对静态文件的排除，避免静态资源被错误代理到PHP-FPM。

说明 #

• cgi.fix_pathinfo参数不影响此问题，因为该参数仅处理PHP对路径信息的解析，而非Apache传递给PHP-FPM的原始参数。
• auto_prepend_file属于临时 workaround，通过在脚本执行前修改$_SERVER['SCRIPT_NAME']实现兼容，但可能引发其他兼容性问题，不推荐作为长期解决方案。

内容的提问来源于stack exchange，提问作者mbrampton