Nginx 默认内置 ngx_http_fastcgi_module 模块,无需安装或加载,只需正确配置 fastcgi_pass、SCRIPT_FILENAME 等参数并与 PHP-FPM 协同即可处理 PHP 请求。

Linux 下 Nginx 本身不“安装 fastcgi 模块”,而是通过内置的 ngx_http_fastcgi_module 与 PHP-FPM 协同工作。这个模块在主流发行版的 Nginx 二进制包中默认已启用,无需额外编译或安装。真正需要做的是正确配置它,并配合 PHP-FPM 进行调优,才能高效处理 PHP 请求。
确认 fastcgi 模块已就绪
Nginx 的 FastCGI 功能是核心模块,不是插件。验证方式很简单:
- 运行
nginx -V 2>&1 | grep -o with-http_fastcgi_module,若输出该字符串,说明已编译支持 - 绝大多数 Ubuntu/Debian/CentOS 官方仓库安装的 Nginx 都包含此模块,无需手动编译
- 不需要执行
load_module加载,也不用修改nginx.conf启用——它始终可用
PHP-FPM 是关键依赖,必须先装好
FastCGI 协议需要后端进程管理器,PHP-FPM 就是标准选择:
- Ubuntu/Debian:
sudo apt install php-fpm php-cli(自动启用对应版本服务,如 php8.2-fpm) - CentOS/RHEL:
sudo dnf install php-fpm php-common - 启动并设为开机自启:
sudo systemctl enable --now php-fpm - 检查监听地址:
sudo ss -tulpn | grep ':9000\|php.*sock',确认它在 Unix socket(推荐)或 TCP 端口上运行
基础 Nginx 配置要写对
在站点 server 块中添加以下 location 规则,这是 PHP 请求能被正确转发的前提:
立即学习“PHP免费学习笔记(深入)”;
-
location ~ \.php$:正则匹配以 .php 结尾的请求(注意转义点号) -
fastcgi_pass unix:/run/php/php8.2-fpm.sock:指向 PHP-FPM 实际监听的 socket 路径(路径需与php-fpm.conf中listen =一致) -
include fastcgi_params;:加载 Nginx 内置的标准参数集 -
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;:这一行不可省略,否则 PHP-FPM 找不到脚本文件 - 建议加上
fastcgi_index index.php;和try_files $uri =404;防止路径遍历风险
几项实用优化建议
提升 PHP 处理稳定性和响应速度,重点不在 Nginx 模块本身,而在协同配置:
-
优先用 Unix Socket:比
127.0.0.1:9000更快、更安全;确保 Nginx worker 用户(如 www-data)对该 socket 文件有读写权限 -
调整 fastcgi 缓冲区:大响应体(如导出报表)易触发磁盘临时文件,可加大缓冲:
fastcgi_buffer_size 128k; fastcgi_buffers 8 256k; fastcgi_busy_buffers_size 512k; -
启用 FastCGI 缓存:对静态化内容(如博客文章页)有效,需在
http{}块定义缓存区,再在 location 中启用fastcgi_cache并设置fastcgi_cache_valid -
PHP-FPM 进程池调优:在
/etc/php/*/fpm/pool.d/www.conf中设pm = dynamic,根据内存合理配pm.max_children(例如 2GB 内存建议设为 20–30)



















