Windows下Nginx与PHP配置教程:手把手教你搭建开发环境
在Windows系统中搭建Nginx+PHP的运行环境,常用于本地开发、测试或搭建小型Web服务。相比传统的Apache+PHP,Nginx轻量高效,且对高并发支持更优。本文将从安装到验证,用最简洁的步骤带你完成配置。
一、准备工作:下载必要软件
- Nginx:访问Nginx官网,选择Windows稳定版(如
nginx-1.21.6),解压到任意目录(如C:\nginx)。 - PHP:推荐使用PHP官方Windows版,选择线程安全(TS)版本(如
php-8.1.13-Win32-vs16-x64),解压到目录(如C:\php)。 - 验证工具:下载文本编辑器(如Notepad++)用于修改配置文件。
二、Nginx基础配置:启动与端口检查
-
解压与启动:
将Nginx压缩包解压到C:\nginx,进入nginx目录,双击nginx.exe启动。打开任务管理器,确认nginx.exe进程存在。
若需修改默认端口(默认80),打开nginx/conf/nginx.conf,找到listen 80;,改为其他端口(如8080)。 -
测试Nginx:
浏览器访问http://localhost(或修改后的端口),若显示Nginx欢迎页,说明Nginx启动成功。
三、PHP安装与FastCGI配置
-
解压与初始化:
将PHP压缩包解压到C:\php,复制php.ini-development为php.ini(开发环境),打开php.ini:- 启用关键扩展:搜索
extension=mysqli、extension=pdo_mysql,取消注释(删除行首;)。 - 设置时区:
date.timezone = Asia/Shanghai。 - 开启路径解析(避免路径暴露漏洞):
cgi.fix_pathinfo=1。
- 启用关键扩展:搜索
-

启动PHP-FastCGI:
Windows下需手动启动PHP的FastCGI进程。打开命令行(Win+R输入cmd),进入C:\php,执行:php-cgi.exe -b 127.0.0.1:9000 -c C:\php\php.ini命令解释:
-b指定FastCGI监听地址(127.0.0.1:9000),-c指定php.ini路径。此时任务管理器会新增php-cgi.exe进程。
四、Nginx与PHP关联:配置解析规则
打开C:\nginx\conf\nginx.conf,在server块中添加PHP解析配置:
server {
listen 80;
server_name localhost;
root html; # 网站根目录(默认C:\nginx\html)
index index.php index.html;
# 处理PHP文件
location ~ \.php$ {
root html;
fastcgi_pass 127.0.0.1:9000; # 指向PHP-FastCGI
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
}
保存后,重启Nginx:在Nginx目录执行nginx -s reload(或先关闭再启动)。
五、验证配置:创建测试文件
在C:\nginx\html目录下新建info.php,内容如下:
<?php phpinfo(); ?>
浏览器访问http://localhost/info.php,若显示PHP配置页面,说明环境搭建成功。
六、常见问题与解决
- 访问PHP文件显示源码:
检查php-cgi.exe是否启动,nginx.conf中fastcgi_pass是否指向127.0.0.1:9000。 - 端口冲突:
若Nginx启动失败,检查80端口是否被占用(如IIS),修改Nginx端口或停止占用程序。 - PHP扩展不生效:
确认php.ini中扩展路径正确(如extension_dir = "ext"),且扩展文件存在(C:\php\ext目录)。
总结
通过以上步骤,你已完成Windows下Nginx+PHP的基础配置。后续可根据需求安装数据库(如MySQL)、配置SSL证书,或优化Nginx性能参数。开发过程中,记得保持Nginx和PHP-FastCGI的后台运行,避免服务中断。
