Windows下配置Nginx与PHP环境详细步骤：从下载到测试验证完整教程

来源：站长平台作者：陈平安头衔：全栈工程师

导读：本期聚焦于陈平安创作的《Windows下配置Nginx与PHP环境详细步骤：从下载到测试验证完整教程》，敬请观看详情。想在Windows本地搭个Nginx加PHP的开发环境，按这个步骤来准没错。详细讲解从下载Nginx和NTS版PHP，到修改php.ini和nginx.conf配置FastCGI通信的完整流程。包含启动PHP-CGI、设置虚拟主机以及访问phpinfo测试环境的实操方法，同时总结了502错误、文件下载等常见问题的排查思路，帮你快速搞定本地环境搭建。

Windows下配置Nginx和PHP的完整教程：从下载到测试一步步搞定

在Windows环境下搭建Nginx和PHP的组合，是很多开发者进行本地项目开发、学习和调试的首选方案。Nginx以其轻量级和高并发处理能力著称，通过FastCGI协议与PHP-CGI进程高效通信，能够快速构建出稳定可靠的Web服务。下面我们将从环境准备开始，逐步讲解如何在Windows系统上完成配置，并进行基础测试。

一、下载所需软件

1. 下载Nginx

首先需要获取Nginx的Windows版本。打开浏览器，访问Nginx官方网站（nginx.org），在下载页面找到适用于Windows的稳定版本。通常是一个zip格式的压缩包，文件名类似nginx-1.xx.x.zip。下载后，将压缩包解压到一个不含中文和空格的目录下，例如D:\nginx。这样做可以避免路径中包含中文字符或空格导致的解析问题。解压完成后，你会看到nginx.exe可执行文件以及conf、logs、html等文件夹。其中conf文件夹里存放着主要的配置文件nginx.conf，这是我们后续需要重点修改的地方。

对于大多数开发场景，选择主线稳定版就足够了。压缩包内已经包含了基本的MIME类型映射文件和FastCGI参数模板，不需要额外下载其他模块。初次接触Nginx的朋友，可以先花几分钟熟悉一下目录结构，尤其是nginx.conf的位置。

2. 下载PHP

接下来下载PHP。前往PHP官方Windows下载页面（windows.php.net/download），根据你的系统架构（32位或64位）选择合适的版本。这里有一个关键点：由于Nginx是通过FastCGI方式与PHP通信，因此必须选择Non Thread Safe（非线程安全，简称NTS）版本。线程安全版本（Thread Safe）是为Apache等以模块方式运行的Web服务器设计的，在FastCGI模式下使用NTS版本会更加稳定，资源占用也更低。

下载完成后，同样将压缩包解压到一个不含空格的目录，比如D:\php。解压后，请确认目录内是否存在php-cgi.exe这个文件，它是后续启动FastCGI进程的核心程序。为了方便在命令行中调用PHP相关命令，你可以将PHP目录路径添加到系统环境变量PATH中，不过这并不是必需的步骤。

二、配置PHP

在修改Nginx之前，需要先让PHP具备作为FastCGI进程运行的基本能力。PHP的主配置文件是php.ini，我们需要对它进行调整。

1. 创建php.ini文件

进入PHP解压目录D:\php，你会看到两个示例配置文件：php.ini-development和php.ini-production。开发环境下建议使用前者，因为它开启了更多的调试信息和错误显示。复制php.ini-development文件，并将副本重命名为php.ini。如果你希望在生产环境中使用，也可以复制php.ini-production，但本地开发时保留php.ini-development的配置会更方便。

2. 修改关键配置项

用记事本或其他文本编辑器打开php.ini，找到并修改以下几项。注意，修改时请去掉行首的分号（分号表示注释）。

; 设置PHP扩展所在的目录，请根据实际解压路径填写
extension_dir = "D:/php/ext"

; 开启常用扩展模块，去掉行首的分号即可启用
extension=curl
extension=gd2
extension=mbstring
extension=mysqli
extension=pdo_mysql

; 设置时区为上海，避免日期时间相关函数报错
date.timezone = Asia/Shanghai

; 关闭路径信息修正，这是Nginx环境下的安全建议
cgi.fix_pathinfo=0

解释一下每个设置的作用：

extension_dir：告诉PHP去哪里找扩展文件（.dll文件）。路径中的斜杠要使用正斜杠或双反斜杠，例如D:/php/ext或D:\\php\\ext，否则Windows可能会误读。
开启的扩展：curl用于网络请求，gd2用于图像处理，mbstring用于多字节字符串操作，mysqli和pdo_mysql用于连接MySQL数据库。这些是开发中最常用的扩展，按需开启即可。
date.timezone：设置默认时区。如果不设置，很多日期函数会报警告。国内用户建议设为Asia/Shanghai。
cgi.fix_pathinfo=0：这是一个重要的安全设置。当PHP接收到一个不存在的文件路径时，默认行为可能会尝试解析上一层路径，这可能导致远程文件包含漏洞。设置为0可以关闭这一行为，降低安全风险。

保存php.ini后，PHP的基本配置就完成了。如果将来需要用到其他扩展，只需要回到这个文件，去掉对应extension=前的分号即可。

三、配置Nginx

Nginx的核心配置位于D:\nginx\conf\nginx.conf。这个文件定义了监听端口、网站根目录、默认首页以及如何处理不同类型的请求。我们需要修改其中的server块，使得以.php结尾的请求能够被转发给PHP-CGI处理。

1. 编辑nginx.conf

用文本编辑器打开nginx.conf，找到默认的server块（通常在文件后半部分），将其内容替换或修改为如下所示：

server {
    listen       80;
    server_name  localhost;
    
    # 设置网站文档根目录
    root   D:/nginx/html;
    
    # 添加index.php作为默认首页文件
    index  index.html index.htm index.php;

    location / {
        # 对于普通请求，先尝试查找具体文件，失败则交给index.php处理
        try_files $uri $uri/ /index.php?$query_string;
    }

    # 匹配所有以.php结尾的请求，通过FastCGI转发给PHP-CGI
    location ~ \.php$ {
        fastcgi_pass   127.0.0.1:9000;
        fastcgi_index  index.php;
        # 关键：将脚本在服务器上的绝对路径传递给PHP
        fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
        include        fastcgi_params;
    }
}

逐项说明：

listen 80：让Nginx监听本机所有网卡的80端口。如果你的电脑上已经有其他程序占用了80端口（比如IIS或Skype），可以改成其他端口，比如8080。
server_name localhost：指定该站点匹配来自localhost的请求。你也可以换成自己的域名，本地测试就用localhost。
root D:/nginx/html：定义网站文件的存放位置。所有通过浏览器访问的资源都会基于这个目录查找。你可以根据需要修改成其他路径，比如D:/wwwroot。
index index.html index.htm index.php：设置默认首页文件。当访问一个目录时，Nginx会按顺序尝试这些文件。加上index.php是为了让PHP文件也能作为首页。
location /块：这里的try_files指令非常实用。它的意思是：当收到一个请求时，首先尝试查找对应的文件（$uri），如果文件不存在，再尝试查找目录（$uri/），如果目录也不存在，就把请求重写到/index.php并附上原始的查询字符串（?$query_string）。这为许多现代PHP框架（如ThinkPHP、Laravel）提供了简洁的URL重写支持，无需额外配置伪静态规则。
location ~ \.php$块：正则表达式匹配所有以.php结尾的请求。在这个块中：

fastcgi_pass 127.0.0.1:9000：指定PHP-CGI监听的地址和端口。必须与后续启动PHP-CGI时设定的端口完全一致。
fastcgi_index index.php：当请求只指定了目录而没有具体文件名时，默认使用index.php。
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name：这是最关键的一行。它将请求的脚本在服务器上的物理路径（例如D:/nginx/html/phpinfo.php）动态传递给PHP。$document_root就是上面定义的root值，$fastcgi_script_name是请求的脚本名称（如/phpinfo.php）。
include fastcgi_params：引入Nginx自带的FastCGI参数文件，里面包含了其他必要的参数，如QUERY_STRING、REQUEST_METHOD等。

保存nginx.conf后，配置就完成了。注意每次修改配置文件后，都需要重启或重新加载Nginx才能生效。

四、启动服务并测试

1. 启动PHP-CGI

打开命令提示符（CMD），依次输入以下命令启动PHP-CGI进程：

D:
cd D:\php
php-cgi.exe -b 127.0.0.1:9000

执行后，命令行窗口会保持打开状态，没有任何输出信息——这很正常，说明PHP-CGI已经在后台监听9000端口了。千万不要关闭这个窗口，一旦关闭，PHP-CGI进程就会终止，Nginx就无法处理PHP请求了。如果你觉得这个窗口碍眼，可以使用一些小工具（如RunHiddenConsole）让它后台运行，例如：

RunHiddenConsole php-cgi.exe -b 127.0.0.1:9000

这样就不会弹出额外的命令行窗口。

2. 启动Nginx

另开一个命令提示符窗口，进入Nginx目录并启动服务：

D:
cd D:\nginx
start nginx

start nginx命令会让Nginx以后台进程方式运行。启动时如果配置有误，Nginx会在logs\error.log文件中记录错误信息，你可以根据日志排查问题。常用的管理命令还有：

nginx -s reload：重新载入配置文件（修改配置后常用）。
nginx -s stop：快速停止服务。
nginx -s quit：等待处理完现有请求后再正常退出。

3. 测试PHP环境

现在我们来验证环境是否搭建成功。在Nginx的网站根目录D:\nginx\html下新建一个名为phpinfo.php的文件，写入以下代码：

<?php
phpinfo();
?>

保存文件后，打开浏览器，在地址栏输入http://localhost/phpinfo.php。如果一切正常，你会看到一个包含PHP详细配置信息的页面，包括PHP版本号、已加载的扩展、服务器环境变量等。这表明Nginx已经成功将.php请求转发给了PHP-CGI，环境搭建完成。

五、常见问题排查

即使严格按照步骤操作，也可能会遇到一些问题。以下是几种最常见的故障及解决方法。

1. 502 Bad Gateway错误

现象：浏览器显示“502 Bad Gateway”。

原因：Nginx收到了请求，但无法与后端的PHP-CGI进程通信。通常是因为PHP-CGI没有启动，或者监听的地址/端口与Nginx配置不一致。

解决：

检查PHP-CGI的命令行窗口是否还开着，有没有意外关闭。
确认PHP-CGI监听的端口确实是9000（可以在命令行中运行netstat -ano | findstr 9000查看端口占用情况）。
检查nginx.conf中fastcgi_pass的值是否与启动PHP-CGI时指定的-b参数一致。

2. 404 Not Found错误

现象：访问http://localhost/phpinfo.php时显示“404 Not Found”。

原因：文件路径不对，或者Nginx配置中的root指令指向了错误的目录。

解决：

确认phpinfo.php确实存在于D:\nginx\html目录下。
检查nginx.conf中的root指令是否写对了路径，注意盘符大小写和斜杠方向。
另外，SCRIPT_FILENAME参数拼接后的路径是否正确也很关键。你可以在phpinfo.php中添加一行代码echo __FILE__;来查看实际执行的脚本路径，如果路径不对，调整root或SCRIPT_FILENAME的写法。

3. 浏览器直接下载PHP文件而不是执行

现象：访问.php文件时，浏览器弹出下载对话框，或者直接显示PHP源代码。

原因：Nginx没有将.php请求交给FastCGI处理，而是当作普通静态文件返回了。

解决：

检查nginx.conf中是否包含了location ~ \.php$这个配置块，并且没有被注释掉。
确保该配置块内的fastcgi_pass和fastcgi_param等指令正确无误。
如果有其他location规则干扰，可以尝试将这个块放到所有通用规则之前，或者增加优先级（比如使用^~修饰符）。

如果以上方法都无法解决问题，建议查看Nginx的错误日志（logs\error.log）和PHP的错误日志（如果配置了error_log的话），它们通常能最直接地指出问题所在。

通过以上步骤，你就可以在Windows系统上成功搭建一套轻量高效的Nginx与PHP运行环境。无论是用来调试代码、学习新技术，还是运行小型项目，这套组合都能提供稳定的服务基础。随着你对Nginx和PHP了解的深入，还可以进一步优化配置，比如启用HTTPS、配置虚拟主机、调整性能参数等。希望这篇教程对你有所帮助！

Windows Nginx PHP配置 FastCGI 本地开发环境修改时间：2026-08-12 00:01:35

免责声明：已尽一切努力确保本网站所含信息的准确性。网站内容多为原创整理与精心编撰，观点力求客观中立。本站旨在免费分享，内容仅供个人学习、研究或参考使用。若引用了第三方作品，版权归原作者所有。如内容涉及您的权益，请联系我们处理。