Nginx+PHP-FPM高性能搭配需严丝合缝匹配系统、版本、路径、权限与超时参数：一选Ubuntu 22.04/CentOS Stream 9等LTS系统并更新；二装PHP8.2-FPM与Nginx，配dynamic进程模型及OPcache；三确保fastcgi_pass与listen路径一致、SCRIPT_FILENAME精准拼接；四通过phpinfo()验证，并依502/504错误对症排查进程、权限与超时。
直接上手配Nginx + PHP-FPM，关键不在步骤多，而在每一步的匹配要严丝合缝。系统、版本、路径、权限、超时——错一个，502或504就等着你。
一、装对版本，先稳住底座
选长期支持（LTS）系统，Ubuntu 22.04 或 CentOS Stream 9 更稳妥。别用非标版本，否则扩展装不上、服务起不来是常事。
- 更新系统：sudo apt update && sudo apt upgrade -y（Ubuntu/Debian）或sudo dnf update -y（RHEL系）
- 装PHP核心与FPM：比如 Ubuntu 上运行sudo apt install php8.2 php8.2-fpm php8.2-mysql php8.2-curl php8.2-gd php8.2-mbstring php8.2-xml php8.2-zip
- 装Nginx：sudo apt install nginx，装完立刻检查状态：sudo systemctl status nginx，确保 active (running)
二、让PHP-FPM“活”起来且不乱占内存
默认配置是玩具级，生产环境必须调进程模型和内存参数，否则高一点的并发就卡死或崩掉。
- 编辑池配置：sudo nano /etc/php/8.2/fpm/pool.d/www.conf
- 设为动态模式：pm = dynamic
- 按物理内存估算子进程数：比如服务器有 4GB 内存，建议pm.max_children = 50（每个进程约占用 120–150MB）
- 空闲进程范围设合理：pm.start_servers = 5，pm.min_spare_servers = 3，pm.max_spare_servers = 10
- 开OPcache加速：opcache.enable=1 和 opcache.memory_consumption=128 要在/etc/php/8.2/fpm/php.ini里确认生效
三、Nginx转发PHP请求，不能只抄模板
location ~ \.php$ 块看着简单，但fastcgi_pass地址、SCRIPT_FILENAME路径、用户权限三者不一致，立马报错。
立即学习“PHP免费学习笔记（深入）”；
- 先看PHP-FPM监听在哪：sudo cat /etc/php/8.2/fpm/pool.d/www.conf | grep listen，常见值是/run/php/php8.2-fpm.sock
- Nginx配置中必须完全一致：fastcgi_pass unix:/run/php/php8.2-fpm.sock;
- SCRIPT_FILENAME别依赖$document_root自动拼接，尤其用了alias或root没写在server块里时。稳妥写法：fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;，并确保root /var/www/your-site;已明确定义
- 测试配置语法：sudo nginx -t，通过后再重载：sudo systemctl reload nginx
四、验证与排障，从最常见错误入手
部署后打不开？别急着重装，先盯住两个信号：
- 502 Bad Gateway：基本是通信断了。查三件事——PHP-FPM进程是否在跑（systemctl status php8.2-fpm）、socket路径是否完全一致、Nginx worker用户（通常是www-data）是否有权限读该socket文件（ls -l /run/php/）
- 504 Gateway Timeout：连上了但等太久。同步调两端超时：Nginx里加fastcgi_read_timeout 300;，PHP-FPM里设request_terminate_timeout = 300（单位秒），并确认request_slowlog_timeout也调高便于定位慢脚本
- 创建/var/www/your-site/info.php，内容为，访问看页面是否出来，且$_SERVER['SERVER_SOFTWARE']显示 Nginx，不是 Apache
