PHP在Nginx上运行的核心是配置Nginx将.php请求通过fastcgi_pass转发给PHP-FPM处理，需确保PHP-FPM已启动、监听地址与Nginx配置一致，并正确设置fastcgi_params及SCRIPT_FILENAME等关键参数。
PHP 要在 Nginx 上跑起来，核心不是改 PHP 配置，而是让 Nginx 知道怎么把 .php 请求转给 PHP-FPM 处理——漏掉这一步，页面直接下载或 502 是常态。
确认 PHP-FPM 已安装并运行
很多“配置失败”其实卡在底层服务没起来。Nginx 本身不解析 PHP，全靠 php-fpm 进程监听 socket 或端口。
- 检查服务状态：
systemctl status php-fpm（CentOS/RHEL）或systemctl status php8.1-fpm（Ubuntu/Debian，版本号需匹配） - 确认监听地址：查看
/etc/php/*/fpm/pool.d/www.conf中的listen行，常见值为listen = /run/php/php8.1-fpm.sock或listen = 127.0.0.1:9000 - 若改过
listen，记得同步更新 Nginx 配置里的fastcgi_pass，否则 502 错误必现
Nginx server 块中必须包含 fastcgi_pass 和相关参数
只写 location ~ \.php$ 而不配 fastcgi_pass，Nginx 就不会转发请求，浏览器可能直接下载 .php 文件。
location ~ \.php$ {
include fastcgi_params;
fastcgi_pass unix:/run/php/php8.1-fpm.sock; # 必须与 php-fpm 的 listen 一致
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}-
include fastcgi_params是基础变量集，不能省；但其中的SCRIPT_FILENAME默认值常不生效，所以必须显式重写 - 用
unix:socket 比127.0.0.1:9000更快且避免端口冲突，但路径权限要对：php-fpm进程用户（如www-data）需有读写 socket 文件权限 - 如果站点用到 PATH_INFO（如 ThinkPHP 的
index.php/a/b），还需加fastcgi_split_path_info和对应参数，否则路由失效
PHP 本身的配置影响运行结果但不决定能否启动
很多人花时间调 php.ini 却忽略 Nginx+PHP-FPM 协作逻辑。真正导致“白屏”“500”的常见 PHP 配置项只有几个：
立即学习“PHP免费学习笔记（深入）”；
-
display_errors = Off→ 开发时建议设为On，配合error_log = /var/log/php/error.log查问题 -
max_execution_time和memory_limit在处理大文件或复杂逻辑时才关键，刚配环境时不用急着调 -
date.timezone不设会导致getdate()等函数警告，但不阻断执行 - 扩展是否启用（如
mysqli、pdo_mysql）取决于应用需求，Nginx 启动不依赖它们
最容易被忽略的是 socket 文件路径权限和 SCRIPT_FILENAME 的拼接逻辑——$document_root 必须真实指向 PHP 文件所在目录，否则 File not found 错误会静默发生，日志里只显示 “Primary script unknown”。
