phpEnv运行PHP页面变成下载解决Nginx不解析PHP问题-php教程-PHP中文网

Nginx未将.php文件交由PHP-FPM处理，导致浏览器直接下载而非执行。需依次确认：PHP-FPM服务是否active(running)；location ~ .php$配置是否在生效server块内且fastcgi_pass路径与php-fpm实际监听（socket或端口）一致；SCRIPT_FILENAME参数是否正确、root与index指令是否匹配；文件权限及cgi.fix_pathinfo=0是否设置正确。

phpenv运行php页面变成下载解决nginx不解析php问题

PHP 页面被浏览器直接下载，不是执行，说明 Nginx 根本没把 .php 文件交给 PHP 处理器——它只是当普通静态文件吐给了浏览器。这不是 PHP 代码写错了，而是 Nginx 和 PHP-FPM 之间“没接上头”。

确认 PHP-FPM 进程是否在运行

没进程，Nginx 再配对也没用。别跳过这步，很多人改完配置 reload 就以为好了，其实 php-fpm 压根没起来。

运行 sudo systemctl status php*-fpm（如 php8.2-fpm），看输出里有没有 active (running)
如果报 Unit php8.2-fpm.service could not be found，说明没装或服务名不对，先查系统里实际安装的版本：ls /etc/init.d/ | grep fpm 或 php -v 看版本，再装对应包（如 sudo apt install php8.2-fpm）
启动并设开机自启：sudo systemctl start php8.2-fpm && sudo systemctl enable php8.2-fpm

检查 Nginx 的 location ~ \.php$ 配置是否生效

这是最常出问题的地方：配置写了，但不在当前生效的 server 块里；或者路径写死了，和实际 root 不匹配；或者用了 include fastcgi_params 却漏了关键参数。

确保该 location 块在你当前使用的 server 块内（比如 /etc/nginx/sites-enabled/default），而不是注释掉或放在其他未加载的文件里
fastcgi_pass 必须指向真实存在的 socket 或端口，常见错误：
- unix:/run/php/php8.2-fpm.sock —— 查看 ls /run/php/ 确认文件存在
- 127.0.0.1:9000 —— 查 sudo netstat -tulpn | grep :9000 看端口是否被 php-fpm 监听
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; 这行不能少，且 $document_root 必须和该 server 块的 root 值一致，否则 PHP 找不到文件
别用 include snippets/fastcgi-php.conf 就以为万事大吉——它只是个快捷方式，内部仍依赖 $document_root 正确设置

验证 index.php 是否被识别为默认首页

访问域名根路径（如 http://localhost/）时，Nginx 默认只找 index.html，不会自动尝试 index.php，除非你明确告诉它。

Nginx Reverse Proxy

配置 Nginx 反向代理，实现域名绑定。用户说“绑定域名”“配置 Nginx”“反向代理”时触发，将域名绑定到指定 IP:端口。

下载

在 server 块里检查是否有 index 指令，且包含 index.php：index index.php index.html;
如果只写了 index index.html;，那么即使 index.php 存在，也会 403 或 404，而不是执行
注意：这个指令必须在 server 块顶层，不能只写在某个 location 里

权限与 cgi.fix_pathinfo 设置容易被忽略

这两个问题不报错，但会导致 PHP 脚本被当作文件下载，或返回 502/500 却查不到日志。

PHP 文件本身权限应为 644，所在目录为 755；Nginx 工作用户（通常是 www-data 或 nginx）必须有读取权限：sudo chown -R www-data:www-data /var/www/html
cgi.fix_pathinfo=0 必须在 PHP-FPM 的 php.ini 中设置（通常在 /etc/php/*/fpm/php.ini），设为 1 可能导致路径解析错误，触发安全机制而拒绝执行
改完 php.ini 后一定要重启 php-fpm：sudo systemctl restart php8.2-fpm，reload 不生效