Nginx 运行 PHP 需配置 PHP-FPM 并正确匹配监听地址，添加 fastcgi_pass 转发规则，确保权限与路径正确，最后通过 info.php 验证解析能力。
如果您希望在 Nginx 服务器上运行 PHP 脚本，但页面仅显示 PHP 源码或返回 502/504 错误，则可能是由于 Nginx 未正确与 PHP 处理器（如 PHP-FPM）协同工作。以下是实现 Nginx 运行 PHP 的具体配置步骤：
一、安装 PHP 及 PHP-FPM
PHP 本身不直接响应 HTTP 请求，Nginx 需通过 FastCGI 协议将 PHP 请求转发给 PHP-FPM 进程管理器处理。因此必须确保 PHP-FPM 已安装并处于活动状态。
1、在 Ubuntu/Debian 系统中执行：sudo apt update && sudo apt install php-fpm。
2、在 CentOS/RHEL 系统中执行：sudo yum install php-fpm 或 sudo dnf install php-fpm。
立即学习“PHP免费学习笔记（深入）”；
3、启动并启用 PHP-FPM 服务：sudo systemctl start php-fpm && sudo systemctl enable php-fpm。
二、确认 PHP-FPM 监听方式与地址
PHP-FPM 默认可能使用 Unix 套接字文件（如 /run/php/php-fpm.sock）或 TCP 端口（如 127.0.0.1:9000）。Nginx 的 fastcgi_pass 指令必须与之严格匹配，否则连接失败。
1、查看 PHP-FPM 主配置文件位置：sudo php --ini | grep "Loaded Configuration File"。
2、打开该配置文件（如 /etc/php/*/fpm/pool.d/www.conf），查找 listen = 行，确认其值为 /run/php/php-fpm.sock 或 127.0.0.1:9000。
3、若修改了 listen 值，需重启服务：sudo systemctl restart php-fpm。
三、配置 Nginx server 块支持 PHP
Nginx 不内置 PHP 解析能力，必须显式定义 location 块，将 .php 请求交由 fastcgi_pass 转发至 PHP-FPM，并设置必要参数传递请求上下文。
1、编辑站点配置文件（如 /etc/nginx/sites-available/default 或 /etc/nginx/conf.d/example.com.conf）。
把任意文章或文档内容转换成精美的全屏翻页 HTML 演示文件（幻灯片风格）。当用户发来一篇文章、文档链接、Markdown 内容、或粘贴的文本，并且希望生成演示用的 HTML 时触发。支持任意内容来源：iWiki 链接、KM 链接、本地文件路径、直接粘贴的文本。生成的 HTML 文件保存到本地工作区，并通过企微直接发送给用户。触发词示例：帮我把这篇文章做成PPT、转成演示文档、生成HTML幻灯片、做个演示、转成可以演示的格式、article to deck、make a slide。
2、在 server 块内添加以下 location 配置（适配 Unix 套接字方式）：location ~ \.php$ { include snippets/fastcgi-php.conf; fastcgi_pass unix:/run/php/php-fpm.sock; }。
3、若 PHP-FPM 使用 TCP 方式，则改为：fastcgi_pass 127.0.0.1:9000;。
4、确保包含 fastcgi_params 或 fastcgi.conf 文件，且其中已定义 SCRIPT_FILENAME $document_root$fastcgi_script_name。
四、验证 PHP 文件解析能力
配置完成后，Nginx 仅在接收到以 .php 结尾的 URI 请求时才触发 FastCGI 转发；若未命中 location 规则，请求将被当作静态文件处理，导致源码泄露或 404。
1、在网站根目录（如 /var/www/html/）创建测试文件：echo "" | sudo tee /var/www/html/info.php。
2、重新加载 Nginx 配置：sudo nginx -t && sudo systemctl reload nginx。
3、通过浏览器访问 http://your_server_ip/info.php，确认显示 PHP 信息页而非源代码。
五、排查常见权限与路径问题
即使 fastcgi_pass 地址正确，若 Nginx 工作进程用户（如 www-data 或 nginx）无权访问 PHP-FPM 套接字文件或网站根目录，仍会返回 502 Bad Gateway。
1、检查套接字文件权限：ls -l /run/php/php-fpm.sock，确保属组包含 Nginx 用户（如 www-data）。
2、若权限不符，修改 www.conf 中的 listen.owner 和 listen.group 为 Nginx 运行用户及组，再重启 PHP-FPM。
3、确认网站根目录所有者为 Nginx 用户：sudo chown -R www-data:www-data /var/www/html。
