Nginx和PHP如何搭配使用？快速搭建Nginx+PHP开发环境的步骤

· 日常编程 · 84608

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 update
sudo apt install nginx

装完Nginx，我们得确保它能正常跑起来。简单检查一下服务状态：

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信息页面，就说明一切正常。


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拿到这些信息后，就直接打包发送给客户端浏览器。


为什么说它关键？


    

  1. 
解耦与专业分工： Nginx专注于处理网络连接和静态资源，PHP-FPM专注于PHP代码的执行。这种分工让两者都能发挥各自的最大优势，提高了整个系统的效率和稳定性。
    2. 

  2. 
进程管理： PHP-FPM能够管理多个PHP工作进程。这意味着它可以根据服务器负载动态地启动或停止PHP进程，从而优化资源使用。比如，它可以配置为在请求量大时增加进程数，请求量小时减少进程数，避免了PHP在每次请求时都重新启动解释器的开销，显著提升了性能。
    3. 

  3. 
隔离与安全： 不同的PHP应用可以运行在不同的PHP-FPM进程池下，甚至可以使用不同的用户和权限，这提供了更好的隔离性。即使一个应用出现问题，也不会轻易影响到其他应用，提升了安全性。
    4. 

  4. 
稳定性： PHP-FPM能够监控PHP进程的健康状况。如果某个PHP子进程因为代码错误或资源耗尽而崩溃，PHP-FPM可以自动重启它，而不会导致整个Web服务中断。
    5. 

  5. 
配置灵活性： 它允许对每个进程池进行独立的配置，比如内存限制、执行时间限制等，这对于多租户或不同项目有不同资源需求的环境来说非常有用。
    6. 



简而言之，没有PHP-FPM，Nginx就无法高效、稳定地服务PHP应用。它让Nginx能够专注于其网络传输的强项，同时为PHP提供了一个高性能、可管理、健壮的运行环境。


Nginx配置PHP时有哪些核心指令需要注意？


在Nginx中配置PHP，主要是通过




location




块来定义如何处理










.php










文件请求。这里面有几个核心指令，理解它们是配置成功的关键，也是我个人在调试Nginx配置时经常会去检查的地方。


    

  1. 

    

    

    

    

    location ~ \.php$
    

    

    

    

    

      

    • 这是最基础的匹配规则，用正则表达式来匹配所有以

      

      

      

      

      .php
      

      

      

      

      

      结尾的URI。
      

      

      ~
      

      

      表示区分大小写的正则匹配，
      

      

      $
      

      

      表示匹配字符串的末尾。这个块内部的指令将专门用于处理PHP文件。
      • 

    • 
我的理解： 这就像给Nginx一个明确的指示：“嘿，看到文件名是.php的，就按我下面说的来办！”
      • 

    

    2. 

  2. 

    

    

    root /path/to/your/project;
    

    

    

      

    • 虽然这个指令不直接在

      

      

      

      location ~ \.php$
      

      

      

      

      块内，但它在
      

      

      

      server
      

      

      

      块中的位置至关重要。它定义了Nginx查找文件时的根目录。当Nginx接收到一个请求，比如
      

      

      /index.php
      

      

      ，它会尝试在
      

      

      

      

      

      

      root
      

      

      

      

      

      

      指令指定的目录下找到这个文件。
      • 

    • 
我的理解： 这是告诉Nginx你的网站文件放在哪里，所有的相对路径都以此为基准。如果设置错了，Nginx会找不到你的PHP文件，直接返回404。
      • 

    

    3. 

  3. 

    

    

    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没接电话（没启动或监听地址不对），那肯定就没法通信了。
      • 

    

    4. 

  4. 

    

    

    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”。
      • 

    

    5. 

  5. 

    

    

    index index.php index.html index.htm;
    

    

    

      

    • 虽然通常放在

      

      

      server
      

      

      

      块中，但它影响到Nginx在请求一个目录（如
      

      

      /
      

      

      ）时，会尝试查找哪些文件作为默认索引文件。如果你的入口文件是
      

      

      

      index.php
      

      

      

      ，确保它在这里被列出。
      • 

    • 
我的理解： 这是你网站的“门牌号”规则。当有人只敲门不报具体房间号时，Nginx会按照这个列表依次尝试，找到哪个文件就打开哪个。
      • 

    

    6. 



理解并正确配置这些指令，是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 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开发环境的步骤的详细内容，更多请关注骃骐网【www.myinqi.com】。






相关推荐：

    
        

	

		
如何在安卓手机上运行Python脚本_通过Termux搭建完整的Python运行环境

	

	
Termux中运行Python脚本需三步到位：先执行termux-setup-storage获取存储权限，再用pkg install python clang libffi-dev openssl-dev装齐依赖，最后配置pip清华源并优先通过science-packages仓库安装科学计算库。 python 脚本在安卓手机上能直接运行，但前提是环境配对——Termux 不是“装了就能跑”，它需要...

	


        

	

		
什么是Python的.pyc文件_环境搭建中关于字节码缓存的深度解析

	

	
.pyc 文件是 Python 源码编译生成的字节码缓存文件，仅用于加速模块导入；它非必需，不跨版本兼容，仅在 import 时生成，存于 pycache 中并受 magic number 校验。 什么是 .pyc 文件？它不是编译产物，而是字节码缓存 .pyc 文件是 Python 源码（.py）被编译成字节码后，序列化写入磁盘的二进制文件。它不是像 C 的 .o 那样的“可执行目标文件”，也不...

	


        

	

		
如何在阿里云服务器上快速搭建Python Flask环境_配置安全组与反向代理

	

	
生产部署需用Nginx+Gunicorn组合：安全组仅放行80/443，Gunicorn绑定127.0.0.1:8000，Nginx proxy_pass与之匹配，关闭Flask的app.run和debug，确保文件权限属Nginx用户。 直接上手就能跑通，不需要宝塔、不依赖 Docker，用原生 Nginx + Gunicorn 就够用。关键不是“装什么”，而是“端口开对没、host 绑对没、反...

	


        

	

		
如何在PHP在线执行中实现邮件发送？配置PHPMailer的详细步骤解析

	

	
使用PHPMailer库是PHP在线环境发送邮件的推荐方式，需通过Composer安装或手动引入文件，配置SMTP信息（如Host、Port、加密方式）、发件人收件人、邮件内容，并启用异常处理和调试模式排查问题。常见失败原因包括SMTP认证错误、未启用openssl扩展、防火墙限制或密码未使用应用专用密码。为避免邮件被标记为垃圾邮件，应使用可信SMTP服务商、配置SPF/DKIM/DMARC、提供...

	


        

	

		
SOAP服务压力测试？JMeter测试步骤？

	

	
答案是：使用JMeter对SOAP服务进行压力测试需创建测试计划、配置线程组模拟并发，添加HTTP请求采样器并正确设置协议、路径及方法，配置HTTP信息头管理器以匹配SOAP版本的Content-Type和SOAPAction，通过Body Data输入SOAP信封XML，利用CSV数据文件实现参数化，结合XPath Extractor处理动态关联，添加监听器如查看结果树和聚合报告以分析响应时间、...

	


        

	

		
如何在PHP环境中使用Laravel？Laravel开发环境的搭建与配置

	

	
在PHP环境中搭建Laravel需先安装PHP 8.1+及必要扩展，再安装Composer，通过它创建项目，配置.env文件并启动开发服务器。 在PHP环境中搭建和使用Laravel，核心在于准备好PHP运行环境、Composer依赖管理工具，以及一个合适的Web服务器，然后通过Composer创建并配置Laravel项目。这就像是为你的应用搭建一个坚实的地基，每一步都至关重要，但实际操作起来远比...

	


        

	

		
如何在PHP环境中配置CodeIgniter？CodeIgniter开发环境的搭建指南

	

	
配置CodeIgniter环境需确保PHP、Web服务器和数据库协同工作，核心步骤包括：选择兼容的CI版本（CI3需PHP 5.6+，CI4需PHP 7.3+），正确设置$config['base_url']和$config['index_page']，配置数据库连接信息，启用URL重写规则（Apache需开启mod_rewrite并配置.htaccess，Nginx需设置try_files），并...

	


        

	

		
如何在Linux系统上搭建PHP环境？一步步教你完成PHP开发环境配置

	

	
答案：在Ubuntu上搭建PHP开发环境需安装Nginx、PHP-FPM和MariaDB，配置Nginx与PHP-FPM协同工作，并通过info.php测试环境。 在Linux系统上搭建PHP开发环境，说白了，就是要把Web服务器（比如Nginx或Apache）、PHP解释器（通常是PHP-FPM）以及一个数据库（如MariaDB或MySQL）这几个核心组件安装好，并让他们能协同工作。这听起来可能...

	


        

	

		
如何为PHP代码添加许可证保护？使用SourceGuardian实现许可证管理的步骤是什么？

	

	
使用SourceGuardian保护PHP代码需安装编码器、配置项目、选择保护级别（如加密、域名绑定、时间限制）、生成许可证模板、编码文件并集成验证逻辑，最后分发加密文件与许可证，同时确保服务器安装对应加载器。 为PHP代码添加许可证保护，核心思路在于通过特定的编码工具对源代码进行加密和混淆，使其难以被未经授权的用户阅读、修改或逆向工程。同时，这些工具会集成一套许可证管理系统，允许开发者根据预设的...