在windows 11上可手动解压配置nginx 1.30.5与php 8.3.32 ts版,通过php-cgi.exe模拟php-fpm实现fastcgi通信,无需安装服务或数据库,适合本地开发调试;需匹配x64架构、安装vs2022运行库、正确设置php.ini扩展路径及时区,并配置nginx.conf中fastcgi_pass及script_filename参数,最后用批处理启动php-cgi和nginx,访问localhost/test.php验证成功。

在 Windows 11 上搭建 Nginx 1.30.5 + PHP 8.3.32 环境,核心是让两个独立进程协同工作:Nginx 处理 HTTP 请求并转发 .php 文件给 PHP-FPM(Windows 下用 php-cgi.exe 模拟),PHP 执行脚本后将结果返回给 Nginx。整个过程无需安装服务、不依赖数据库,纯手动解压配置即可完成,适合开发调试和轻量本地测试。
下载与准备必要组件
确保使用最新稳定版本,并注意架构匹配(Windows 11 全系推荐 x64):
-
Nginx 1.30.5:从 nginx.org 官网 下载 Windows 版 zip 包(非源码),解压到路径如
C:\nginx,路径中不能含中文或空格。 -
PHP 8.3.32 TS(线程安全):从 windows.php.net 下载 Thread Safe ZIP 包(如
php-8.3.32-Win32-vs16-x64.zip),解压至C:\php。 -
Visual C++ 运行库:PHP 8.3 依赖 VS2022 运行时,需安装
vc_redist.x64.exe(微软官网可搜“Microsoft Visual C++ 2022 Redistributable”)。
配置 PHP:启用扩展与时区
进入 C:\php,复制 php.ini-production 并重命名为 php.ini;用记事本或 VS Code 编辑:
- 取消注释并修正扩展路径:
extension_dir = "C:/php/ext"(注意斜杠方向,Windows 下可用正斜杠)。 - 启用常用扩展(去掉前面的分号):
extension=mysqli、extension=pdo_mysql、extension=openssl、extension=mbstring。 - 设置时区:
date.timezone = Asia/Shanghai。 - 可选但推荐:开启 OPcache 提升性能,取消
;opcache.enable=1和;opcache.enable_cli=1的注释。
配置 Nginx:连接 PHP-CGI
编辑 C:\nginx\conf\nginx.conf,重点修改 server 块内内容:
- 确认网站根目录(例如设为
C:/www):root C:/www;,并创建该文件夹。 - 确保
index包含index.php:index index.php index.html;。 - 定位到
location ~ \.php$块,替换为以下标准 FastCGI 配置:
location ~ \.php$ {
root C:/www;
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
⚠️ 注意:root 必须与上方 server 的 root 一致或显式指定,否则 SCRIPT_FILENAME 路径会出错导致 404 或 502。
启动与验证流程
不装服务,用批处理快速启停(建议放在 C:\nginx 目录下):
-
php_start.bat(保存为 ANSI 或 UTF-8 无 BOM):
@echo off echo Starting PHP-CGI... C:\php\php-cgi.exe -b 127.0.0.1:9000 -c C:\php\php.ini
-
nginx_start.bat:
@echo off echo Starting Nginx... C:\nginx\nginx.exe -c C:\nginx\conf\nginx.conf
- 先双击运行
php_start.bat(窗口保持打开),再运行nginx_start.bat。 - 创建测试文件
C:\www\test.php,内容为:<?php phpinfo(); ?>
浏览器访问 https://www.php.cn/link/983379e5eacf56a55f44720792d81bc2,看到 PHP 信息页即成功。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











