Windows系统下Nginx配置PHP失败解决与完整配置方法
在Windows系统中部署Nginx+PHP环境时，很多开发者会遇到配置失败、PHP页面无法解析、返回404或空白页等问题。本文将先梳理常见失败原因，再给出完整的配置步骤，帮助大家快速搭建可用的运行环境。
一、常见配置失败原因排查
如果配置完成后无法正常解析PHP文件，可以先对照以下常见问题逐一排查：
PHP未以FastCGI模式运行，或监听端口和Nginx配置中的端口不一致
Nginx配置中未正确关联PHP处理规则，或路径匹配错误
PHP安装目录未添加到系统环境变量，或php-cgi进程启动失败
文件路径包含中文或空格，导致Nginx无法正确读取文件
PHP相关扩展未开启，或php.ini配置文件路径错误
二、前置准备
在正式配置前，需要先准备好以下软件，建议全部安装到无中文、无空格的路径下，例如D:/server目录：
Nginx：前往官网下载Windows稳定版，解压到
D:/server/nginxPHP：前往官网下载Windows版PHP（选择Non Thread Safe版本，适配FastCGI模式），解压到
D:/server/php
三、PHP基础配置
首先完成PHP的基础配置，确保PHP可以正常运行：
1. 进入PHP解压目录，复制php.ini-development文件，重命名为php.ini，作为PHP的配置文件。
2. 用记事本打开php.ini，修改以下配置项（去掉项前的分号注释即可）：
; 开启FastCGI支持，取消下面两项的注释 cgi.fix_pathinfo=1 fastcgi.impersonate=1 ; 设置扩展目录，根据实际PHP路径修改 extension_dir = "D:/server/php/ext" ; 按需开启常用扩展，例如MySQL扩展 extension=mysqli extension=pdo_mysql
3. 测试PHP是否正常运行：按下Win+R键，输入cmd打开命令提示符，执行以下命令启动PHP FastCGI进程：
D:/server/php/php-cgi.exe -b 127.0.0.1:9000 -c D:/server/php/php.ini
如果命令执行后窗口保持运行状态，没有报错信息，说明PHP FastCGI启动成功，监听端口为9000。注意不要关闭这个命令提示符窗口，后续测试时需要保持进程运行。
四、Nginx配置关联PHP
接下来修改Nginx配置文件，让Nginx可以将PHP请求转发给PHP FastCGI处理：
1. 进入Nginx安装目录下的conf文件夹，打开nginx.conf配置文件。
2. 找到server配置块，修改根目录和PHP处理规则，完整配置示例如下：
server {
# 监听端口，默认80，如果被占用可以修改为其他端口比如8080
listen 80;
# 服务器名称，本地测试可以填localhost
server_name localhost;
# 网站根目录，设置为你的项目存放路径，不要有中文和空格
root D:/server/nginx/html;
# 默认首页文件
index index.html index.htm index.php;
# 处理PHP文件的配置
location ~ .phpnbsp;{
# 转发到PHP FastCGI的地址，要和PHP启动时的监听地址一致
fastcgi_pass 127.0.0.1:9000;
# 默认FastCGI配置
fastcgi_index index.php;
# 引入FastCGI参数配置
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
}配置修改完成后保存文件，打开命令提示符，进入Nginx目录执行以下命令重新加载配置：
D:/server/nginx/nginx.exe -s reload
五、验证配置是否成功
在Nginx配置的网站根目录D:/server/nginx/html下，新建一个index.php文件，写入以下测试代码：
<?php phpinfo(); ?>
打开浏览器，访问http://localhost或者http://localhost:端口号（如果修改了Nginx监听端口），如果看到PHP的配置信息页面，说明Nginx+PHP配置成功。
六、常见错误解决方法
1. 访问PHP文件显示下载而不是直接解析
原因：Nginx没有正确配置PHP处理规则，或者location ~ .php$块配置错误。解决方法：检查nginx.conf中PHP相关配置是否正确，确保fastcgi_param SCRIPT_FILENAME的路径配置正确，并且重新加载Nginx配置。
2. 页面返回404错误
原因：网站根目录路径配置错误，或者PHP文件的路径不存在。解决方法：检查root配置的路径是否正确，路径分隔符使用正斜杠/，不要使用反斜杠，同时确认访问的PHP文件确实存在于根目录下。
3. 页面空白无任何输出
原因：PHP FastCGI进程没有启动，或者端口被占用。解决方法：检查启动PHP的命令是否正确，确认9000端口没有被其他程序占用，如果被占用可以修改PHP监听端口和Nginx中的fastcgi_pass端口为其他未被占用的端口。
4. 提示找不到php.ini文件
原因：启动PHP时没有指定正确的php.ini路径。解决方法：启动php-cgi时通过-c参数指定php.ini的完整路径，例如D:/server/php/php-cgi.exe -b 127.0.0.1:9000 -c D:/server/php/php.ini。
七、设置开机自动启动（可选）
每次手动启动Nginx和PHP进程比较麻烦，可以使用Windows任务计划或者第三方工具将两者设置为开机自动启动，也可以使用批处理脚本一键启动：
新建start_server.bat文件，写入以下内容：
@echo off start /b D:/server/php/php-cgi.exe -b 127.0.0.1:9000 -c D:/server/php/php.ini start /b D:/server/nginx/nginx.exe
双击这个批处理文件就可以同时启动PHP和Nginx，方便日常开发使用。