RHEL8与CentOS7下httpd的PHP解析行为差异问题咨询

根因定位 #

故障核心触发点是RHEL8环境PHP运行模式与原CentOS7环境不一致，未加载Apache mod_php处理模块，和已排查到的现象完全对应：

• phpinfo页面缺失apache2handler板块是直接判定依据：CentOS7下remi-php73源安装PHP时会默认部署mod_php（即libphp7.so），PHP作为Apache内置模块运行，自动继承Apache的目录权限、路径解析规则，include语句的相对路径、$_SERVER['DOCUMENT_ROOT']映射完全和虚拟主机配置对齐，因此全目录include逻辑正常。
• 观测到的软件源差异是故障直接诱因：remi-safe源是Remi仓库提供的通用兼容源，不会自动启用对应PHP版本的系统模块流，也不会自动安装Web服务适配组件，仅部署了CLI版本的PHP包。当前环境大概率是仅在站点根目录做了临时PHP解析匹配（比如根目录做了php-cgi的handler匹配、子目录未覆盖规则），或是php-fpm对接时的路径参数传递、open_basedir限制未覆盖子目录，才会出现仅根目录include正常、子目录逻辑失效的问题。
• 两台服务器php -v输出一致仅能说明CLI环境的PHP版本相同，无法证明Apache侧的PHP处理模块配置一致。

修复步骤（对齐CentOS7原有mod_php运行模式，兼容性最高） #

1. 先清理当前冲突的PHP组件：

   dnf remove php* php-common -y
   

2. 启用Remi源的PHP7.3模块流，安装Apache适配的mod_php及业务所需扩展：

   dnf module enable php:remi-7.3 -y
   dnf install php php-apache php-opcache php-mbstring php-gd php-mysqlnd -y
   # 其余PHP扩展可根据业务实际需求追加安装
   

3. 确认PHP模块加载配置已自动生成，安装php-apache包后会自动创建/etc/httpd/conf.modules.d/10-php.conf，核心配置如下：

   LoadModule php7_module modules/libphp7.so
   <FilesMatch \.php$>
       SetHandler application/x-httpd-php
   </FilesMatch>
   

4. 检查业务虚拟主机配置，确认站点全目录（含所有子目录）的AllowOverride、open_basedir配置和CentOS7环境保持一致，不存在目录级的PHP解析拦截规则。
5. 重启httpd服务加载配置：

   systemctl restart httpd
   

验证方式 #

重启服务后访问任意子目录下的phpinfo探测页面，确认页面出现apache2handler板块，此时测试子目录PHP include逻辑即可恢复正常，和原CentOS7环境运行行为完全一致。

可选方案说明：如果计划使用RHEL8默认推荐的php-fpm模式运行PHP，可保留fpm部署架构，但需要逐一校正fpm池配置中的chroot、chdir、php_admin_value[open_basedir]参数，以及Apache反向代理规则中SCRIPT_FILENAME、DOCUMENT_ROOT的参数传递逻辑，确保子目录请求的路径能被fpm正确识别。该方案需要调整的配置项较多，对CentOS7迁移的存量业务来说，优先选择mod_php模式对齐原有运行环境的改造成本最低。

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