Apache HTTP Server安装mod_fcgid模块实现FastCGI通信配置-Apache-PHP中文网

apache本身不内置fastcgi支持，必须加载mod_fcgid模块启用；该模块是官方推荐的现代实现，兼容apache 2.4+、自带进程管理，配置需三步：启用模块、设置execcgi权限与handler、调优fcgidmaxprocesses等参数。

apache 本身不内置 fastcgi 支持，必须通过加载 mod_fcgid 模块来启用。该模块是 apache 官方推荐的现代 fastcgi 实现，比老旧的 mod_fastcgi 更稳定、维护活跃、兼容 apache 2.4+，且自带进程管理能力，无需额外部署守护进程。

不同系统操作略有差异，但核心目标一致：让 fcgid_module 可被 Apache 加载。

Ubuntu/Debian 系统：运行 sudo apt install libapache2-mod-fcgid，安装后模块自动写入 mods-enabled/fcgid.load；再执行 sudo a2enmod fcgid（确保启用），最后 sudo systemctl restart apache2
CentOS/RHEL 或源码编译 Apache：需手动下载匹配 Apache 版本的 mod_fcgid 源码，编译时指定 --with-apxs 路径；编译完成后，在 httpd.conf 中添加 LoadModule fcgid_module modules/mod_fcgid.so，路径须与实际一致
Windows 环境：从 Apache Lounge 下载对应版本的 mod_fcgid.so（注意 VC 运行库依赖），复制到 Apache\modules\ 目录；在 httpd.conf 末尾添加 LoadModule fcgid_module modules/mod_fcgid.so

仅加载模块还不够，Apache 必须知道哪些文件交给 mod_fcgid 执行，并允许其运行。

Apache 2.4.62

Apache 2.4.62 官方 tar.gz 源码包是 Linux 及类 Unix 系统构建 Web 服务器的核心基础。通过源码编译安装，开发者能够灵活定制模块、优化性能并精准控制安装路径，满足多样化的业务需求。

下载

在站点配置中（如 sites-enabled/000-default 或 <directory></directory> 块内）添加 Options +ExecCGI，否则 Apache 会拒绝执行 .fcgi 或 .php 文件
用 AddHandler fcgid-script .php .fcgi 明确指定可执行后缀，避免任意文件被误触发
对目标目录统一设置处理器：SetHandler fcgid-script，这样该目录下所有匹配后缀的文件都走 FastCGI 流程

示例片段：

<directory>
    Options +ExecCGI
    AddHandler fcgid-script .php .fcgi
    SetHandler fcgid-script
</directory>

FastCGI 不直接调用 PHP 解析器，而是通过 FcgidWrapper 指向 php-cgi 可执行文件，并传递必要环境变量。

在 <ifmodule mod_fcgid.c></ifmodule> 块中添加：FcgidWrapper "/usr/bin/php-cgi" .php（Linux）或 FcgidWrapper "D:/PHP/php-cgi.exe" .php（Windows）
指定 php.ini 位置：FcgidInitialEnv PHPRC "/etc/php/8.2/apache2"（Linux）或 FcgidInitialEnv PHPRC "D:/PHP"（Windows）
同步 PHP 的请求限制：FcgidInitialEnv PHP_FCGI_MAX_REQUESTS 1000，该值应 ≥ FcgidMaxRequestsPerProcess，防止 PHP 进程提前退出
补全 MIME 类型识别：AddType application/x-httpd-php .php，确保浏览器正确解析响应