如何快速配置 Apache 与 PHP-FPM 的 FastCGI 连接-Apache-PHP中文网

最直接有效的方式是用mod_proxy_fcgi + proxypassmatch，无需额外安装旧模块；apache 2.4+默认支持，配置简洁稳定，需启用proxy和proxy_fcgi模块，确认php-fpm监听地址，并在虚拟主机中用sethandler或proxypassmatch正确映射路径及script_filename。

如何快速配置 apache 与 php-fpm 的 fastcgi 连接

最直接有效的方式是用 mod_proxy_fcgi + ProxyPassMatch，无需额外安装旧模块（如 mod_fastcgi 或 mod_fcgid），Apache 2.4+ 默认已支持，配置简洁、稳定、易维护。

确认 PHP-FPM 已就绪

确保 PHP-FPM 正在运行，并监听指定地址：

检查服务状态：sudo systemctl status php*-fpm（如 php8.2-fpm）
确认监听方式：默认通常为 Unix 套接字（如 /run/php/php8.2-fpm.sock）或 TCP 端口（如 127.0.0.1:9000）
查看实际路径：打开 /etc/php/*/fpm/pool.d/www.conf，找 listen = 行

启用必要 Apache 模块

运行以下命令启用代理核心模块（多数系统已默认启用，但需确认）：

sudo a2enmod proxy proxy_fcgi
若使用 Unix 套接字，还需启用 proxy_unix（较新版本可选，非必需）
重启生效：sudo systemctl restart apache2

在虚拟主机中配置 FastCGI 代理

编辑站点配置（如 /etc/apache2/sites-available/your-site.conf），在 <virtualhost></virtualhost> 内添加：

用 Unix 套接字（推荐，性能更好）：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

<filesmatch>
    SetHandler "proxy:unix:/run/php/php8.2-fpm.sock|fcgi://localhost/"
</filesmatch>

或用 TCP（适合调试或跨机部署）：

<filesmatch>
    SetHandler "proxy:fcgi://127.0.0.1:9000"
</filesmatch>

注意：
– SetHandler 方式比 ProxyPassMatch 更灵活，自动处理 PATH_INFO；
– 路径中的 localhost 是占位符，不参与 DNS 解析，仅用于 fcgi 协议标识；
– 若文档根目录非默认，建议配合 ProxyFCGISetEnvIf 设置 SCRIPT_FILENAME（见下条）。

关键环境变量补全（避免 503/404）

PHP-FPM 需要正确的 SCRIPT_FILENAME 才能找到 PHP 文件。添加以下配置防错：

<filesmatch>
    SetHandler "proxy:unix:/run/php/php8.2-fpm.sock|fcgi://localhost/"
    ProxyFCGISetEnvIf "true" SCRIPT_FILENAME /var/www/html%{REQUEST_URI}
</filesmatch>

把 /var/www/html 替换为你的实际 DocumentRoot 路径。该行确保请求 /index.php 时，PHP-FPM 收到的脚本路径是 /var/www/html/index.php。

保存后执行 sudo systemctl reload apache2，再用 curl -I http://yoursite/info.php 测试是否返回 200 及 X-Powered-By: PHP 即可确认成功。