Nginx通过FastCGI协议将PHP请求转发给PHP-FPM处理，实现Web服务与应用逻辑解耦。搭建环境需安装Nginx、PHP-FPM，配置Nginx的server块，指定root目录，使用location ~ .php$匹配PHP文件，通过fastcgi_pass指向PHP-FPM的socket或端口，并引入fastcgi-php.conf参数。配置后创建phpinfo()文件验证，检查服务状态、日志及权限，确保Nginx和PHP-FPM正常通信，避免404、502等错误。
Nginx和PHP的搭配使用，核心在于Nginx作为高性能的Web服务器，将动态的PHP请求通过FastCGI协议转发给独立的PHP-FPM（FastCGI Process Manager）进程池处理。PHP-FPM负责解析并执行PHP脚本，然后将处理结果回传给Nginx，最终由Nginx返回给客户端。这种架构将Web服务与应用逻辑处理解耦，提升了稳定性和效率。快速搭建一个Nginx+PHP开发环境，通常涉及安装Nginx、PHP及其FPM组件，并配置Nginx指向PHP-FPM的监听端口或Unix socket。
解决方案
搭建Nginx+PHP开发环境，我通常倾向于在Linux系统上操作，因为其稳定性和命令行工具的强大。这里以Ubuntu为例，一个相对通用的流程会是这样：
首先，我们得把Nginx装上。这玩意儿在Linux上安装基本就是一条命令的事儿，快得很：
sudo apt updatesudo apt install nginx
装完Nginx，我们得确保它能正常跑起来。简单检查一下服务状态：
立即学习“PHP免费学习笔记（深入）”；
sudo systemctl status nginx
如果看到“active (running)”，那就没问题了。接着是PHP和PHP-FPM。PHP-FPM是关键，它才是真正跑PHP代码的“幕后英雄”。通常，我们会安装最新稳定版的PHP，比如PHP 8.2，以及对应的FPM模块，还有一些常用的扩展：
sudo apt install php8.2-fpm php8.2-mysql php8.2-cli php8.2-curl php8.2-gd php8.2-mbstring php8.2-xml php8.2-zip
安装完成后，PHP-FPM服务也会自动启动。同样，检查一下状态：
sudo systemctl status php8.2-fpm
确认PHP-FPM也在运行。现在，最关键的一步来了：配置Nginx，让它知道如何把PHP请求“扔”给PHP-FPM处理。这通常是在Nginx的站点配置文件里完成的。我们创建一个新的站点配置，或者修改默认的。
我个人习惯为每个项目创建一个独立的Nginx配置文件，比如
/etc/nginx/sites-available/your_project.conf
。内容大致会是这样：
server { listen 80; server_name your_domain.local www.your_domain.local; # 开发环境可以设为localhost或自定义域名 root /var/www/your_project; # 你的项目根目录 index index.php index.html index.htm; location / { try_files $uri $uri/ =404; } # 重点在这里：处理PHP文件 location ~ .php$ { include snippets/fastcgi-php.conf; # 引入FastCGI配置片段，简化配置 fastcgi_pass unix:/var/run/php/php8.2-fpm.sock; # PHP-FPM的Unix socket路径 # 或者如果你配置了PHP-FPM监听TCP端口，比如：fastcgi_pass 127.0.0.1:9000; } # 可选：禁止访问某些隐藏文件或目录 location ~ /.ht { deny all; } error_log /var/log/nginx/your_project_error.log; access_log /var/log/nginx/your_project_access.log;}
注意
root
指令，要指向你实际存放PHP代码的目录。
fastcgi_pass
指向的是PHP-FPM的监听地址，在Ubuntu上，默认通常是Unix socket文件，路径是
/var/run/php/php8.2-fpm.sock
（具体版本号可能不同）。
配置好后，我们需要将这个配置文件链接到
sites-enabled
目录，让Nginx加载它：
sudo ln -s /etc/nginx/sites-available/your_project.conf /etc/nginx/sites-enabled/
别忘了移除默认的Nginx站点配置，避免端口冲突或不必要的加载：
sudo unlink /etc/nginx/sites-enabled/default
最后，检查Nginx配置语法是否有误，然后重启Nginx服务：
sudo nginx -tsudo systemctl reload nginx
至此，一个基本的Nginx+PHP开发环境就搭建好了。在
/var/www/your_project
目录下创建一个
index.php
文件，写入
，然后访问你的域名，如果能看到PHP信息页面，就说明一切正常。
PHP-FPM在Nginx+PHP架构中扮演什么角色？为何它如此关键？
在我看来，PHP-FPM在Nginx+PHP架构中，简直就是PHP应用的“心脏”和“大脑”，它扮演的角色远不止一个简单的执行器。它之所以关键，是因为Nginx本身并不能直接执行PHP代码。Nginx是个出色的静态文件服务器和反向代理，它处理HTTP请求非常高效，但在遇到动态脚本（比如PHP）时，它就需要一个“翻译官”或者说一个“工作伙伴”来完成任务。
这个“工作伙伴”就是PHP-FPM，全称是FastCGI Process Manager。它的核心职责是管理PHP进程池。当Nginx收到一个对
.php
文件的请求时，它不会自己去解析这个文件，而是通过FastCGI协议，把这个请求以及所有相关的环境变量和参数（比如GET/POST数据、HTTP头等）“扔”给PHP-FPM。
PHP-FPM接收到请求后，会从它的进程池中调度一个空闲的PHP子进程来处理这个请求。这个子进程会加载PHP解释器，执行对应的PHP脚本，然后将脚本的输出（HTML、JSON等）以及HTTP状态码、响应头等信息，通过FastCGI协议再回传给Nginx。Nginx拿到这些信息后，就直接打包发送给客户端浏览器。
为什么说它关键？
解耦与专业分工： Nginx专注于处理网络连接和静态资源，PHP-FPM专注于PHP代码的执行。这种分工让两者都能发挥各自的最大优势，提高了整个系统的效率和稳定性。进程管理： PHP-FPM能够管理多个PHP工作进程。这意味着它可以根据服务器负载动态地启动或停止PHP进程，从而优化资源使用。比如，它可以配置为在请求量大时增加进程数，请求量小时减少进程数，避免了PHP在每次请求时都重新启动解释器的开销，显著提升了性能。隔离与安全： 不同的PHP应用可以运行在不同的PHP-FPM进程池下，甚至可以使用不同的用户和权限，这提供了更好的隔离性。即使一个应用出现问题，也不会轻易影响到其他应用，提升了安全性。稳定性： PHP-FPM能够监控PHP进程的健康状况。如果某个PHP子进程因为代码错误或资源耗尽而崩溃，PHP-FPM可以自动重启它，而不会导致整个Web服务中断。配置灵活性： 它允许对每个进程池进行独立的配置，比如内存限制、执行时间限制等，这对于多租户或不同项目有不同资源需求的环境来说非常有用。
简而言之，没有PHP-FPM，Nginx就无法高效、稳定地服务PHP应用。它让Nginx能够专注于其网络传输的强项，同时为PHP提供了一个高性能、可管理、健壮的运行环境。
Nginx配置PHP时有哪些核心指令需要注意？
在Nginx中配置PHP，主要是通过
location
块来定义如何处理
.php
文件请求。这里面有几个核心指令，理解它们是配置成功的关键，也是我个人在调试Nginx配置时经常会去检查的地方。
location ~ .php$
这是最基础的匹配规则，用正则表达式来匹配所有以
.php
结尾的URI。
~
表示区分大小写的正则匹配，
$
表示匹配字符串的末尾。这个块内部的指令将专门用于处理PHP文件。我的理解： 这就像给Nginx一个明确的指示：“嘿，看到文件名是.php的，就按我下面说的来办！”
root /path/to/your/project;
虽然这个指令不直接在
location ~ .php$
块内，但它在
server
块中的位置至关重要。它定义了Nginx查找文件时的根目录。当Nginx接收到一个请求，比如
/index.php
，它会尝试在
root
指令指定的目录下找到这个文件。我的理解： 这是告诉Nginx你的网站文件放在哪里，所有的相对路径都以此为基准。如果设置错了，Nginx会找不到你的PHP文件，直接返回404。
fastcgi_pass unix:/var/run/php/php8.2-fpm.sock;
或
fastcgi_pass 127.0.0.1:9000;
这是将请求转发给PHP-FPM的关键指令。它告诉Nginx，当处理PHP文件时，应该把请求发送到哪个FastCGI服务器。
unix:/var/run/php/php8.2-fpm.sock
：这是通过Unix socket进行通信。Unix socket通常比TCP/IP socket更快，因为它避免了网络协议栈的开销，在同一台服务器上是首选。路径需要与PHP-FPM的
listen
配置一致。
127.0.0.1:9000
：这是通过TCP/IP端口进行通信。如果PHP-FPM监听在这个地址和端口，Nginx就通过这个地址连接。我的理解： 这就是Nginx和PHP-FPM之间的“电话线”。如果电话线接错了，或者PHP-FPM没接电话（没启动或监听地址不对），那肯定就没法通信了。
include snippets/fastcgi-php.conf;
或
include fastcgi_params;
这两个指令通常用于引入一些标准的FastCGI参数配置。
snippets/fastcgi-php.conf
是Ubuntu/Debian系统Nginx包自带的一个配置片段，里面包含了
fastcgi_params
以及
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
等重要参数。
fastcgi_params
：这个文件包含了FastCGI协议所需的一系列环境变量，比如
REQUEST_METHOD
,
CONTENT_TYPE
,
CONTENT_LENGTH
等。
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
：这是其中最关键的一个参数，它告诉PHP-FPM要执行的PHP脚本的完整路径。
$document_root
就是前面
root
指令定义的值，
$fastcgi_script_name
是请求的PHP文件名。我的理解： 这些
include
指令就像是预设好的“标准信封”，里面装满了PHP-FPM处理请求时需要的所有上下文信息。特别是
SCRIPT_FILENAME
，如果这个参数不对，PHP-FPM就不知道要运行哪个文件，直接报错“File not found”。
index index.php index.html index.htm;
虽然通常放在
server
块中，但它影响到Nginx在请求一个目录（如
/
）时，会尝试查找哪些文件作为默认索引文件。如果你的入口文件是
index.php
，确保它在这里被列出。我的理解： 这是你网站的“门牌号”规则。当有人只敲门不报具体房间号时，Nginx会按照这个列表依次尝试，找到哪个文件就打开哪个。
理解并正确配置这些指令，是Nginx与PHP高效协作的基础。在我日常的开发和部署中，大部分PHP相关的Nginx配置问题，都离不开对这几个指令的检查和调整。
搭建Nginx+PHP环境后，如何验证其正常工作并进行初步故障排查？
搭建完Nginx+PHP环境，最让人期待的就是看到它正常运行起来。验证过程其实很简单直接，但如果遇到问题，就需要一些基本的排查思路。
1. 快速验证：创建
phpinfo.php
文件
这是最经典的验证方法。在你的项目根目录（比如前面配置的
/var/www/your_project
）下，创建一个名为
info.php
或
phpinfo.php
的文件，内容如下：
然后，在浏览器中访问你配置的域名或IP地址加上这个文件名，例如
http://your_domain.local/info.php
。
预期结果： 如果一切正常，你应该能看到一个包含大量PHP配置信息和扩展列表的页面。这意味着Nginx成功接收了请求，将其转发给了PHP-FPM，PHP-FPM也成功执行了PHP脚本并将结果返回给了Nginx，Nginx最终又将结果呈现给了浏览器。
异常情况及初步排查：
看到Nginx的404页面： 这通常意味着Nginx找不到你的
info.php
文件。检查Nginx配置中的
root
指令是否指向了正确的项目目录。确认
info.php
文件是否真的放在了
root
指令指定的目录下。检查Nginx的
location /
块中的
try_files
指令，确保它没有错误地阻止文件查找。看到Nginx的502 Bad Gateway错误： 这是最常见的Nginx+PHP问题，意味着Nginx尝试连接PHP-FPM，但PHP-FPM没有响应或响应了错误。检查PHP-FPM服务状态：
sudo systemctl status php8.2-fpm
(根据你的PHP版本调整)。如果服务没有运行，尝试启动它：
sudo systemctl start php8.2-fpm
。检查
fastcgi_pass
配置： 确认Nginx配置文件中
fastcgi_pass
指令的地址（Unix socket路径或TCP端口）与PHP-FPM的
listen
配置完全匹配。一个字符的错误都可能导致连接失败。检查PHP-FPM日志： 通常在
/var/log/php8.2-fpm.log
或
/var/log/php-fpm/www-error.log
（具体路径可能因发行版和配置而异）。这里可能会有关于PHP-FPM启动失败或处理请求时遇到的具体错误信息。检查文件权限： 确保Nginx用户（通常是
www-data
）有权限访问PHP-FPM的Unix socket文件。
ls -l /var/run/php/php8.2-fpm.sock
可以查看权限。如果权限不对，PHP-FPM可能无法创建socket，或者Nginx无法连接。浏览器直接下载
info.php
文件，而不是执行它： 这意味着Nginx没有将
.php
文件视为需要PHP-FPM处理的动态内容，而是当作静态文件直接发送了。检查Nginx配置中
location ~ .php$
块是否存在且正确。特别是确保
include fastcgi_params;
和
fastcgi_pass
指令在里面。
2. 检查服务日志
日志文件是排查问题的宝藏。
Nginx错误日志： 通常在
/var/log/nginx/error.log
。这里会记录Nginx自身遇到的问题，比如配置语法错误、文件找不到、无法连接FastCGI服务器等。Nginx访问日志： 通常在
/var/log/nginx/access.log
。这里记录了所有对Nginx的HTTP请求，你可以看到请求的URI、状态码（比如200表示成功，404表示未找到，502表示Bad Gateway等）。通过它，你可以确认请求是否到达了Nginx。PHP-FPM错误日志： 前面提过，在
/var/log/php8.2-fpm.log
或类似路径。这里记录了PHP脚本执行时的错误，比如语法错误、运行时错误、内存溢出等。
3. 检查进程和端口
确认Nginx和PHP-FPM进程都在运行：
ps aux | grep nginxps aux | grep php-fpm
看到有相关的进程列表，说明服务至少是启动了的。
确认端口监听：
sudo netstat -tulnp | grep 80 # 检查Nginx是否监听80端口sudo netstat -tulnp | grep 9000 # 如果PHP-FPM监听TCP端口，检查9000端口
如果PHP-FPM使用的是Unix socket，则不需要检查端口，但需要确认socket文件存在且权限正确。
4. 权限问题
这是我个人遇到过比较隐蔽，也比较头疼的问题之一。
Web根目录权限： 确保Nginx用户（通常是
www-data
）对你的项目根目录及其所有文件有读取权限。
sudo chown -R www-data:www-data /var/www/your_projectsudo chmod -R 755 /var/www/your_project
对于某些需要写入的目录（如上传目录、缓存目录），可能需要
775
甚至
777
权限，但这在生产环境要慎用。
通过这些步骤，通常都能定位到Nginx+PHP环境搭建初期遇到的绝大多数问题。记住，日志是你的朋友，它们会告诉你真相。
以上就是Nginx和PHP如何搭配使用？快速搭建Nginx+PHP开发环境的步骤的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1293153.html
微信扫一扫 
支付宝扫一扫 
