Nginx 运行 PHP 需配置 PHP-FPM 并正确匹配监听地址,添加 fastcgi_pass 转发规则,确保权限与路径正确,最后通过 info.php 验证解析能力。

如果您希望在 Nginx 服务器上运行 PHP 脚本,但页面仅显示 PHP 源码或返回 502/504 错误,则可能是由于 Nginx 未正确与 PHP 处理器(如 PHP-FPM)协同工作。以下是实现 Nginx 运行 PHP 的具体配置步骤:
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 默认可能使用 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 不内置 PHP 解析能力,必须显式定义 location 块,将 .php 请求交由 fastcgi_pass 转发至 PHP-FPM,并设置必要参数传递请求上下文。
1、编辑站点配置文件(如 /etc/nginx/sites-available/default 或 /etc/nginx/conf.d/example.com.conf)。
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。
配置完成后,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。
以上就是用nginx能运行php吗_nginx配置php步骤【解答】的详细内容,更多请关注php中文网其它相关文章!
PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号