Linux下Apache 2.4与PHP 5.6.32源码编译：FPM Handler添加失败求助

我来帮你一步步梳理问题、排查安装细节，然后给出PHP-FPM Handler的具体配置方案：

先看你PHP的编译命令：

./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-mysql --enable-fpm && make && make install

这里有两个小细节需要确认：

• --with-apxs2是让PHP生成Apache的mod_php模块，但你同时启用了--enable-fpm，这本身没问题，但要明确：用PHP-FPM的话不需要依赖mod_php，两者可以共存，但配置时要区分开（避免冲突）。
• --with-mysql是针对PHP旧版的mysql扩展，如果你用的是MySQL 5.5+或MariaDB，建议换成--with-mysqli或--with-pdo-mysql，不过这个不影响FPM Handler的配置，只是个兼容性提醒。

另外要确认PHP-FPM是否安装成功：

• 执行/usr/local/php/sbin/php-fpm -v（默认安装路径，若你自定义了路径请替换），能正常输出版本信息说明FPM安装没问题。
• 检查FPM配置文件：默认在/usr/local/php/etc/php-fpm.conf和/usr/local/php/etc/php-fpm.d/www.conf，重点确认www.conf里的监听设置，比如是listen = 127.0.0.1:9000（TCP端口）还是listen = /var/run/php-fpm.sock（Unix套接字），这个地址后面配置Apache要用到。

Apache 2.4 配置PHP-FPM需要依赖mod_proxy_fcgi模块，先确认模块是否加载：

• 执行/usr/local/apache2/bin/httpd -M，查看输出里有没有proxy_fcgi_module (shared)。
  • 如果没有，需要先加载模块：编辑/usr/local/apache2/conf/httpd.conf，添加两行：

    LoadModule proxy_module modules/mod_proxy.so
    LoadModule proxy_fcgi_module modules/mod_proxy_fcgi.so
    

  • 若编译Apache时没开启这两个模块，需要重新编译Apache，加上--enable-proxy --enable-proxy_fcgi参数。

接下来配置PHP请求的处理规则，推荐用虚拟主机配置（更灵活），也可以全局配置：

方式1：虚拟主机内配置（推荐） #

编辑你的虚拟主机配置文件（比如/usr/local/apache2/conf/extra/httpd-vhosts.conf），在对应的<VirtualHost>块中添加：

# 匹配所有.php结尾的文件，交给PHP-FPM处理
<FilesMatch \.php$>
    # 如果FPM用TCP端口监听，用下面这行
    SetHandler "proxy:fcgi://127.0.0.1:9000"
    # 如果FPM用Unix套接字监听，替换成下面这行（注意套接字路径要和www.conf里一致）
    # SetHandler "proxy:unix:/var/run/php-fpm.sock|fcgi://localhost"
</FilesMatch>

# 确保网站根目录的访问权限配置正确
<Directory "/path/to/your/webroot">
    AllowOverride All
    Require all granted
</Directory>

方式2：全局配置（单站点场景） #

编辑/usr/local/apache2/conf/httpd.conf，直接添加：

<FilesMatch \.php$>
    SetHandler "proxy:fcgi://127.0.0.1:9000"
</FilesMatch>

这样所有站点的PHP请求都会交给FPM处理。

如果配置后还是无法正常处理PHP请求，按下面步骤排查：

1. 确认PHP-FPM服务正在运行：执行ps aux | grep php-fpm，查看是否有FPM进程；如果没运行，启动服务：/usr/local/php/sbin/php-fpm，启动失败的话查看日志/usr/local/php/var/log/php-fpm.log找错误原因。
2. 检查Apache错误日志：查看/usr/local/apache2/logs/error_log，有没有关于proxy_fcgi的连接错误，比如无法连接到FPM的端口/套接字。
3. 验证FPM监听地址的可达性：
   • 若用TCP端口：执行telnet 127.0.0.1 9000或nc -zv 127.0.0.1 9000，能连接说明端口正常。
   • 若用Unix套接字：检查套接文件/var/run/php-fpm.sock的权限，确保Apache运行用户（默认是daemon）有读写权限，可以在www.conf里设置listen.mode = 0660，并把listen.owner和listen.group设为Apache的用户组。
4. 测试PHP文件：在网站根目录创建info.php，内容为<?php phpinfo(); ?>，访问该文件：
   • 显示源码：说明Handler未生效，检查Apache配置是否正确加载。
   • 502错误：说明Apache无法连接到PHP-FPM，检查FPM是否运行、监听地址是否正确。
   • 500错误：查看Apache和FPM的日志找具体错误。

你提到的Red Hat开发者指南和Apache Wiki的FPM配置说明都是可靠的参考，但要注意版本对应：你用的是Apache 2.4和PHP 5.6，要找对应版本的文档，避免使用新版本的配置语法（比如Apache 2.4和2.2的权限配置差异很大）。不过上面的步骤已经针对你的版本做了适配，应该能解决问题。

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