Windows下Nginx+PHP环境配置全指南：从安装到测试

在Windows系统中搭建Nginx+PHP运行环境，常用于本地开发、测试或小型Web应用部署。本文将从准备工作到最终验证，详细讲解全流程配置步骤，帮你快速完成环境搭建。

一、准备工作

1. 系统要求：Windows 10/11或Windows Server（推荐64位系统，兼容性更好）。
2. 下载资源：
   • Nginx：官网下载稳定版（如nginx-1.24.0，选择“Windows version”）。
   • PHP：下载Windows Thread Safe版本（如PHP 8.2.10，需与Nginx的线程模型匹配，避免“FastCGI sent in stderr: "无法加载PHP模块"”等错误）。
   • 依赖组件：若PHP启动失败，需安装Microsoft Visual C++ Redistributable（x86/x64，根据系统位数选择）。

二、Nginx安装与验证

1. 解压Nginx：将下载的Nginx压缩包解压至目标目录（如C:\nginx）。
2. 启动Nginx：
   • 方法1：双击nginx.exe（位于解压目录），任务栏会出现Nginx图标。
   • 方法2：打开命令提示符（管理员权限），进入C:\nginx目录，执行nginx.exe。
3. 验证安装：打开浏览器访问http://localhost，若显示Nginx欢迎页面，则安装成功。

三、PHP安装与基础配置

1. 解压PHP：将PHP压缩包解压至C:\php（路径不含空格，避免后续配置错误）。
2. 配置php.ini：
   • 复制php.ini-development重命名为php.ini（生产环境可选择php.ini-production）。
   • 关键修改：
     • 时区设置：date.timezone = Asia/Shanghai（避免PHP函数date()返回错误时间）。
     • 扩展启用：取消注释需用的扩展（如extension=mysqli、extension=pdo_mysql等）。
3. 环境变量配置（可选）：将C:\php添加到系统环境变量Path，方便命令行直接调用php。

四、Nginx与PHP集成配置

核心步骤是让Nginx将.php文件请求转发给PHP-FPM处理。

1. 修改Nginx配置：
   打开C:\nginx\conf\nginx.conf，在server块内添加以下配置（处理PHP请求）：

   location ~ \.php$ {
      fastcgi_pass   127.0.0.1:9000;  # PHP-FPM监听地址（需与PHP-FPM启动端口一致）
      fastcgi_index  index.php;
      fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;  # 指向PHP文件真实路径
      include        fastcgi_params;  # 加载FastCGI参数配置
   }

2. 重启Nginx：
   执行nginx -s reload（命令行，需在Nginx目录），使配置生效。

五、PHP-FPM启动与测试验证

1. 

   启动PHP-FPM：
   在命令行进入C:\php目录，执行：

   php-cgi.exe -b 127.0.0.1:9000 -c php.ini

   （参数-b指定监听地址，-c指定php.ini路径）。若启动无报错，说明PHP-FPM正常运行。

2. 测试PHP环境：
   在Nginx网站根目录（默认C:\nginx\html）创建test.php，内容如下：

   <?php
   phpinfo();

   浏览器访问http://localhost/test.php，若显示PHP信息页面（包含服务器环境、加载的扩展等），则配置成功。

六、常见问题与解决

1. 访问.php文件显示404：

   • 检查Nginx配置中location ~ \.php$是否生效，是否遗漏分号或路径错误。
   • 确认fastcgi_param SCRIPT_FILENAME路径是否与网站根目录一致。

2. 502 Bad Gateway错误：

   • 排查PHP-FPM是否启动（任务管理器查看php-cgi.exe进程）。
   • 检查fastcgi_pass端口是否与PHP-FPM监听端口（默认9000）一致。

3. PHP扩展未加载：

   • 打开php.ini，确认extension_dir路径正确（如extension_dir = "ext"），且扩展文件（如php_mysql.dll）存在。

总结

Windows下Nginx+PHP环境配置的核心是Nginx与PHP-FPM的通信设置。通过本文步骤，可快速搭建稳定的本地开发或测试环境。关键注意事项：避免路径空格、端口冲突（如80端口被占用需修改Nginx端口），以及php.ini的时区和扩展配置。完成后，即可运行WordPress、ThinkPHP等PHP应用。