Nginx和PHP如何搭配使用？快速搭建Nginx+PHP开发环境的步骤-php教程-PHP中文网

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+php开发环境的步骤

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 update
sudo 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 -t
sudo systemctl reload nginx

登录后复制

至此，一个基本的Nginx+PHP开发环境就搭建好了。在

/var/www/your_project

登录后复制

目录下创建一个

index.php

登录后复制

文件，写入

<?php phpinfo(); ?>

登录后复制

，然后访问你的域名，如果能看到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$
```
登录后复制
360智图
AI驱动的图片版权查询平台

143

查看详情
- 这是最基础的匹配规则，用正则表达式来匹配所有以
```
.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

登录后复制

的文件，内容如下：

<?php
phpinfo();
?>

登录后复制

然后，在浏览器中访问你配置的域名或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 nginx
ps 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_project
sudo chmod -R 755 /var/www/your_project
```
登录后复制
对于某些需要写入的目录（如上传目录、缓存目录），可能需要
```
775
```
登录后复制
甚至
```
777
```
登录后复制
权限，但这在生产环境要慎用。

通过这些步骤，通常都能定位到Nginx+PHP环境搭建初期遇到的绝大多数问题。记住，日志是你的朋友，它们会告诉你真相。

以上就是Nginx和PHP如何搭配使用？快速搭建Nginx+PHP开发环境的步骤的详细内容，更多请关注php中文网其它相关文章！