在Windows上搭建Nginx+PHP环境：从零开始的详细指南

为什么要在Windows上安装Nginx和PHP？

很多开发者习惯在Windows系统上进行网站开发，但最终网站会部署到Linux服务器。在本地Windows环境搭建Nginx+PHP组合，可以让你在熟悉的操作系统中测试和开发PHP网站，避免频繁上传到服务器调试的麻烦。Nginx作为轻量级的高性能Web服务器，相比IIS或Apache在某些场景下表现更出色。

准备工作：下载所需软件

1. 获取Nginx for Windows

访问Nginx官网下载Windows版本，选择稳定版（Stable version）的zip包。Windows版的Nginx是绿色软件，解压即可使用，不需要安装。

2. 获取PHP for Windows

到PHP官网下载Windows版本的PHP，建议选择"Non Thread Safe"版本，因为Nginx通常通过FastCGI方式运行PHP，不需要线程安全支持。下载ZIP压缩包格式，不要下载安装程序。

3. 准备测试文件

创建一个简单的PHP文件用于测试环境是否正常工作，比如创建test.php，内容为<?php phpinfo(); ?>。

详细安装配置步骤

第一步：解压软件到合适位置

1. 在C盘或D盘创建一个新文件夹，比如C:\WebServer
2. 将下载的Nginx压缩包解压到此文件夹，重命名为nginx
3. 将PHP压缩包解压到此文件夹，重命名为php
4. 你的目录结构应该是这样的：

   C:\WebServer\
   ├── nginx\
   │   ├── conf\
   │   ├── html\
   │   └── nginx.exe
   └── php\
      ├── ext\
      ├── php-cgi.exe
      └── php.ini-development

第二步：配置PHP环境

1. 进入C:\WebServer\php文件夹
2. 找到php.ini-development文件，复制一份并重命名为php.ini
3. 用记事本打开php.ini，进行以下修改：

; 找到并修改以下配置项
extension_dir = "C:\WebServer\php\ext"  ; PHP扩展目录
cgi.fix_pathinfo=1  ; 确保这一行前面没有分号，值设为1
date.timezone = Asia/Shanghai  ; 设置时区

; 启用常用扩展（去掉前面的分号）
extension=curl
extension=gd
extension=mbstring
extension=mysqli
extension=pdo_mysql
extension=xml

第三步：配置Nginx支持PHP

1. 进入C:\WebServer\nginx\conf文件夹
2. 用记事本打开nginx.conf文件
3. 找到以下部分并进行修改：

server {
    listen       80;  # 监听80端口
    server_name  localhost;  # 本地访问地址

    # 网站根目录设置
    location / {
        root   html;  # 相对路径，对应nginx/html目录
        index  index.php index.html index.htm;  # 添加index.php为默认文件
    }

    # 添加PHP支持配置
    location ~ \.php$ {
        root           html;  # PHP文件所在目录
        fastcgi_pass   127.0.0.1:9000;  # PHP-CGI监听地址
        fastcgi_index  index.php;
        fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
        include        fastcgi_params;
    }
}

第四步：创建启动脚本

由于需要同时启动Nginx和PHP-CGI，创建一个批处理文件会方便很多：

1. 在C:\WebServer文件夹中新建一个文本文件
2. 重命名为start.bat
3. 右键编辑，输入以下内容：

@echo off
echo 正在启动PHP FastCGI...
start "PHP-CGI" /D "C:\WebServer\php" php-cgi.exe -b 127.0.0.1:9000 -c php.ini

timeout /t 2 /nobreak >nul

echo 正在启动Nginx...
start "Nginx" /D "C:\WebServer\nginx" nginx.exe

echo 环境启动完成！
echo 访问地址：http://localhost
echo.
echo 按任意键停止服务并退出...
pause >nul

echo 正在停止服务...
taskkill /F /IM nginx.exe >nul 2>nul
taskkill /F /IM php-cgi.exe >nul 2>nul

echo 服务已停止

4. 再创建一个停止脚本stop.bat：

@echo off
echo 正在停止服务...
taskkill /F /IM nginx.exe >nul 2>nul
taskkill /F /IM php-cgi.exe >nul 2>nul
echo 服务已停止
pause

第五步：测试环境

1. 双击运行start.bat启动服务
2. 打开浏览器，访问http://localhost
3. 如果看到Nginx欢迎页面，说明Nginx启动成功
4. 在C:\WebServer\nginx\html文件夹中创建test.php文件
5. 内容写入：<?php phpinfo(); ?>
6. 访问http://localhost/test.php
7. 如果看到PHP信息页面，说明PHP配置成功

常见问题解决

问题1：端口被占用

如果启动Nginx时提示端口80被占用，可以修改Nginx配置文件的监听端口：

1. 打开nginx.conf
2. 将listen 80;改为listen 8080;
3. 重启Nginx后访问http://localhost:8080

问题2：PHP文件直接下载而不执行

这通常是因为PHP配置没有生效，检查：

• Nginx配置中是否正确添加了PHP的location配置
• PHP-CGI是否正常运行（查看任务管理器是否有php-cgi.exe进程）
• 防火墙是否阻止了9000端口的通信

问题3：访问出现502 Bad Gateway

• 检查PHP-CGI是否启动成功
• 确认Nginx配置中fastcgi_pass的地址和端口与PHP-CGI启动参数一致
• 查看PHP错误日志（需要先在php.ini中配置错误日志）

优化建议

1. 添加环境变量（可选）

为了方便命令行操作，可以将PHP和Nginx添加到系统PATH：

• 右键"此电脑"→属性→高级系统设置→环境变量
• 在系统变量的Path中添加C:\WebServer\php和C:\WebServer\nginx

2. 配置虚拟主机

如果需要同时运行多个网站，可以配置虚拟主机：

1. 在nginx.conf的http段中添加：

   include vhosts/*.conf;

2. 在conf文件夹中创建vhosts文件夹

3. 为每个网站创建独立的配置文件

3. 性能优化

• 调整Nginx的worker_processes为CPU核心数
• 配置PHP的OPcache加速
• 调整PHP-FPM的进程管理设置（如果使用PHP-FPM模式）

进阶方案：使用集成环境

如果你觉得手动配置太复杂，可以考虑以下集成环境：

1. Laragon

轻量级、快速的开发环境，支持Nginx+PHP+MySQL一键安装，特别适合PHP开发。

2. WPN-XM

专门为Windows优化的服务器栈，包含Nginx、PHP、MariaDB等组件。

3. 自己制作绿色版

将配置好的Nginx+PHP环境打包，可以随时复制到其他电脑使用，适合团队统一开发环境。

维护技巧

1. 定期更新：关注Nginx和PHP的安全更新，及时升级
2. 备份配置：修改重要配置前先备份原文件
3. 日志分析：定期查看Nginx和PHP的错误日志，及时发现和解决问题
4. 安全设置：生产环境要关闭PHP错误显示，限制文件权限

通过以上步骤，你应该能在Windows系统上成功搭建Nginx+PHP环境。这个环境虽然主要用于开发和测试，但理解了配置原理后，将来部署到Linux服务器也会更加得心应手。如果在配置过程中遇到任何问题，可以查看相关日志文件，大多数错误信息都会给出明确的解决方向。