本文详解 centos 7 下 apache 2.4（启用 event/prefork mpm）与源码编译的 php 7.2.34 因线程模型不匹配导致 php 文件被当作纯文本返回的核心原因，并提供从配置修复、模块重编译到运行验证的一站式解决流程。
本文详解 centos 7 下 apache 2.4（启用 event/prefork mpm）与源码编译的 php 7.2.34 因线程模型不匹配导致 php 文件被当作纯文本返回的核心原因，并提供从配置修复、模块重编译到运行验证的一站式解决流程。
在 CentOS 7 环境中，当 Apache 2.4 使用 event 或 worker 这类多线程 MPM（Multi-Processing Module），而 PHP 是以默认方式（未启用 ZTS）编译为 mod_php（即 libphp7.so）时，就会触发经典错误：
Apache is running a threaded MPM, but your PHP Module is not compiled to be threadsafe. You need to recompile PHP with --enable-zts
该错误的本质是：线程安全（ZTS, Zend Thread Safety）未启用 → PHP 扩展无法在多线程 Apache 环境中安全运行 → Apache 拒绝加载 libphp7.so，导致 .php 文件不被解析，直接以明文形式返回给浏览器。
⚠️ 注意：您当前的 httpd.conf 中已正确启用了 prefork MPM（单进程多子进程模型，非线程型），且注释掉了 event/worker，这本应规避 ZTS 问题。但关键矛盾在于——您的 Apache 配置与 PHP 编译选项存在隐性冲突。
? 根本原因分析
-
MPM 实际加载状态需验证
尽管 conf.modules.d/00-mpm.conf 中仅启用了 mod_mpm_prefork.so，但仍需确认 Apache 运行时真正加载的是哪个 MPM：/usr/local/apache2/bin/httpd -V | grep -i mpm # 输出应为：Server MPM: prefork
若显示 event 或 worker，说明其他配置文件（如 httpd.conf 顶部或 extra/ 下某 conf）意外启用了线程型 MPM。
立即学习“PHP免费学习笔记（深入）”；
-
PHP 编译缺失关键参数
您使用的编译命令：./configure --with-sqlanywhere --with-apxs=/usr/local/apache2/bin/apxs
❌ 严重遗漏 --enable-zts（启用 Zend 线程安全）和 --with-apxs2（注意路径拼写：apxs ≠ apxs2，且路径应为绝对路径）。
✅ 正确做法分两种场景：-
场景一：坚持使用 prefork MPM（推荐初学者）
无需 ZTS，但必须确保 PHP 与 Apache 的 MPM 严格匹配，且 apxs 路径准确：./configure \ --with-apxs2=/usr/local/apache2/bin/apxs \ --with-sqlanywhere \ --disable-cgi \ --without-pdo-sqlite \ --without-sqlite3 make && make install
-
场景二：切换至 event MPM（高性能需求）
必须启用 ZTS，并禁用不兼容扩展（如 sqlanywhere 在 ZTS 下可能不可用）：./configure \ --enable-zts \ --with-apxs2=/usr/local/apache2/bin/apxs \ --disable-cgi \ --without-pdo-sqlite \ --without-sqlite3 make && make install
-
-
Handler 配置缺失（您答案中的关键补丁）
即使 libphp7.so 成功加载，若未显式声明 .php 文件交由 PHP 处理，Apache 仍会返回源码。您提供的配置是必要补充，但需置于 块内以增强健壮性： <IfModule php7_module> # 启用 PHP 处理器 AddHandler application/x-httpd-php .php .phtml # 更严格的正则匹配（推荐） <FilesMatch "\.ph(p?|tml)$"> SetHandler application/x-httpd-php </FilesMatch> # 可选：设置默认首页支持 PHP <IfModule dir_module> DirectoryIndex index.php index.html </IfModule> </IfModule>
✅ 完整修复步骤（以 prefork + 无 ZTS 为例）
-
停止 Apache 并清理旧模块
/usr/local/apache2/bin/apachectl stop rm -f /usr/local/apache2/modules/libphp7.so
-
重新编译 PHP（修正路径与参数）
cd /path/to/php-7.2.34 make clean # 清理上次编译残留 ./configure \ --with-apxs2=/usr/local/apache2/bin/apxs \ --with-sqlanywhere \ --prefix=/usr/local/php7 \ --disable-cgi make -j$(nproc) && make install
-
验证模块生成
ls -l /usr/local/apache2/modules/libphp7.so # 应存在且非空 /usr/local/apache2/bin/httpd -M | grep php # 应输出 php7_module (shared)
更新 httpd.conf（关键位置）
在 LoadModule php7_module modules/libphp7.so 之后，插入上述块。 -
语法检查与重启
/usr/local/apache2/bin/httpd -t # 必须显示 "Syntax OK" /usr/local/apache2/bin/apachectl start
-
创建测试页验证
echo "<?php phpinfo(); ?>" > /usr/local/apache2/htdocs/test.php curl http://localhost/test.php | head -20 # 应看到 HTML 格式的 phpinfo 输出
⚠️ 重要注意事项
- 路径一致性：--with-apxs2 必须指向您实际安装的 apxs（/usr/local/apache2/bin/apxs），而非系统默认路径。
- 权限问题：确保 daemon 用户（httpd.conf 中 User daemon）对 /usr/local/php7 及其 lib/php/extensions/ 目录有读取权限。
- SQL Anywhere 兼容性：该扩展在 PHP 7.2+ 且启用 ZTS 时可能编译失败，建议生产环境优先使用 MySQLi/PDO_MySQL。
-
替代方案（推荐现代部署）：若无需 mod_php，可改用 PHP-FPM + ProxyPass（解除 Apache 与 PHP 运行时耦合），完全规避 MPM/ZTS 问题：
# 在 httpd.conf 中注释掉 LoadModule php7_module 和 FilesMatch # 添加反向代理配置 <FilesMatch \.php$> SetHandler "proxy:fcgi://127.0.0.1:9000" </FilesMatch>
通过以上结构化操作，您将彻底解决 “Apache threaded MPM vs non-threadsafe PHP” 的核心矛盾，确保 PHP 脚本被正确解析执行。
