PHP文件被下载而非执行，主因是fastcgi_pass路径错误或PHP-FPM未运行；需先确认PHP-FPM服务状态及监听地址，再核对Nginx中fastcgi_pass、include fastcgi_params和SCRIPT_FILENAME三要素是否配置正确。
PHP 文件被下载而不是执行，90% 是 fastcgi_pass 路径错或 PHP-FPM 没在跑；不是 Nginx 没装好，也不是 PHP 版本不兼容。
确认 PHP-FPM 是否已启动并监听正确地址
这是整个链路的第一环。Nginx 只负责转发，如果后端没人接，就只能返回 502 或直接下载 PHP 文件。
- 先查服务状态：
systemctl status php8.1-fpm（Ubuntu/Debian）或systemctl status php-fpm（RHEL/CentOS），确保是active (running) - 再看监听方式：打开
/etc/php/8.1/fpm/pool.d/www.conf（路径随版本变），确认listen行是unix:/run/php/php8.1-fpm.sock还是127.0.0.1:9000—— 前者更常见也更快，但 Nginx 配置里必须用完全一致的路径 - 检查 socket 文件是否存在且权限可读：
ls -l /run/php/php8.1-fpm.sock，属主应为www-data（Debian）或nginx（RHEL），否则 Nginx 进程无法连接
修改 Nginx 站点配置，让 .php 请求进得去、传得准
光加 index.php 不够，关键在 location ~ \.php$ 块是否完整、参数是否对齐。
- 必须包含三要素：
fastcgi_pass（指向上面确认的 socket 或 IP:port）、include fastcgi_params（提供标准环境变量）、fastcgi_param SCRIPT_FILENAME（告诉 PHP-FPM 脚本真实路径） - 常见漏项：
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;—— 缺了这句，PHP-FPM 会找不到文件，报File not found - 别用
snippets/fastcgi-php.conf就以为万事大吉：它可能没定义SCRIPT_FILENAME，或者路径变量名不匹配（比如用$realpath_root却没启用realpath）
验证 Nginx 配置语法 + 重载服务
改完配置不测试就 reload，等于埋雷。很多 403/500 其实是配置写错一行导致的。
立即学习“PHP免费学习笔记（深入）”；
- 永远先跑：
sudo nginx -t—— 它会指出哪一行、哪个文件出错，比如unknown directive "fastcgi_param"说明缩进或分号漏了 - 重载命令用
sudo systemctl reload nginx，不是restart；reload 不中断已有连接，更安全 - 如果提示
conflicting server name，说明多个server块用了相同server_name且监听同端口，删掉重复或加default_server
调试时绕过浏览器缓存和代理干扰
看到空白页或下载行为，别急着重装，先用最简方式确认底层通不通。
- 用
curl -I http://localhost/test.php看响应头：如果是Content-Type: text/html，说明 PHP 执行成功；如果是application/octet-stream，就是 Nginx 没转发，还在当静态文件发 - 临时把
test.php写成<?php echo 'OK'; ?>，排除phpinfo()被禁用或扩展缺失的干扰 - 关掉所有浏览器插件（尤其是广告拦截、隐私保护类），它们有时会篡改
Accept头导致 Nginx 返回异常响应
最容易被忽略的是 SCRIPT_FILENAME 的路径拼接逻辑 —— 它依赖 $document_root 和 $fastcgi_script_name 两个变量同时准确，而后者又受 location 匹配规则影响。一个 root 写错位置，或 location /app/ 里没处理好路径截断，都会让 PHP-FPM 收到错误的物理路径。
