PHP-SRC项目中FPM与httpd ProxyPass的PATH_INFO解码问题解析

在PHP-SRC项目的最新开发中，发现了一个关于FastCGI进程管理器(FPM)与Apache httpd ProxyPass模块配合使用时PATH_INFO环境变量解码不一致的问题。这个问题影响了使用代理方式部署PHP应用时的URL路径处理行为。

问题背景

当PHP通过FPM方式运行并与Apache httpd的ProxyPass或ProxyPassMatch指令配合使用时，PATH_INFO环境变量中的URL编码字符没有被正确解码。这与直接使用SetHandler方式部署PHP应用以及常见的Nginx配置行为不一致。

具体表现为：当访问包含URL编码字符的路径时（如/index.php/アダプタ.php），PATH_INFO环境变量中保留的是编码后的字符串（/%E3%82%A2%E3%83%80%E3%83%97%E3%82%BF.php），而非解码后的Unicode字符。

技术细节分析

这个问题源于FPM在处理ProxyPass转发的请求时，虽然已经对脚本名称(SCRIPT_NAME)部分进行了URL解码，但却遗漏了对PATH_INFO部分的解码处理。这种不一致性会导致：

1. 开发者需要手动对PATH_INFO进行解码处理
2. 同一应用在不同服务器配置下可能表现出不同的行为
3. 处理多字节字符路径时可能出现预期外的结果

在PHP内部实现中，FPM SAPI模块负责将FastCGI请求转换为PHP可理解的服务器环境变量。当通过ProxyPass转发请求时，Apache会将原始URL信息传递给FPM，而FPM需要正确解析这些信息。

解决方案与修复

开发团队已经提交了修复方案，主要修改点包括：

1. 确保PATH_INFO变量与SCRIPT_NAME变量采用相同的解码逻辑
2. 在处理ProxyPass转发的请求时，统一应用URL解码规则
3. 保持与Nginx等服务器配置的行为一致性

修复后，PATH_INFO将正确反映解码后的URL路径，使/index.php/アダプタ.php这样的请求能够正确获取到/アダプタ.php的PATH_INFO值。

影响范围与升级建议

该问题影响PHP 8.3及以上版本中使用FPM与Apache ProxyPass组合的环境。开发者如果遇到以下情况应考虑检查或升级：

1. 应用依赖PATH_INFO处理多语言URL路径
2. 使用ProxyPass方式部署PHP应用
3. 需要确保不同服务器环境下URL处理行为一致

对于无法立即升级的环境，开发者可以在应用代码中手动对PATH_INFO进行urldecode处理作为临时解决方案，但这会增加额外的处理开销和潜在的编码问题风险。

总结

这个问题的修复体现了PHP项目对Web服务器兼容性和一致性的持续改进。通过确保不同部署方式下PATH_INFO处理行为的一致性，减少了开发者面临的配置差异问题，特别是对于需要处理国际化URL的应用程序来说尤为重要。这也提醒我们在使用代理方式部署应用时，需要特别注意URL处理相关的环境变量行为。