前言
对于需要同时进行 .NET 和 PHP 开发的工程师来说，搭建一个本地多语言开发环境能极大提升工作效率。本文将详细介绍如何在 Windows 系统中，基于 .NET 9 开发框架，快速部署 PHP 8.1 与 Nginx 的集成环境。
一、环境搭建准备清单
- 操作系统：Windows 10/11
- 开发框架：.NET 9 SDK
必要组件：
- PHP 8.1 (NTS)
- Nginx 1.25+
- VC++ Redistributable（建议安装最新版）
二、PHP 8.1 安装与配置
1. 下载与部署
- 访问 PHP Windows 官方下载页，选择 8.1 版本的 Non-Thread Safe (NTS) 包
为什么选择 NTS？
NTS 版本更适合 FastCGI 模式运行，避免线程安全问题。
- 解压文件至目标目录（如
C:\php8），建议路径不含空格和中文
2. 核心配置优化
- 复制
php.ini-development为php.ini
cd C:\php8
copy php.ini-development php.ini- 关键配置项修改（用记事本或 VSCode 打开）：
; 启用扩展目录
extension_dir = "ext"
; 设置时区（中国开发者）
date.timezone = Asia/Shanghai
; 启用常用扩展
extension=gd
extension=mysqli
extension=openssl三、Nginx 服务部署指南
- 快速安装步骤
从 Nginx 官网 下载 Windows 稳定版
解压至目标目录（如 C:\nginx） - 配置虚拟主机
编辑 conf/nginx.conf，在 http 块内添加：
server {
listen 80;
server_name localhost;
root C:/www;
# 优先解析 PHP 文件
index index.php index.html;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
fastcgi_pass 127.0.0.1:9000;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}
}- 网站根目录设置
创建 C:\www 目录，并新建测试文件 index.php：
<?php
echo "🎉 环境搭建成功！";
phpinfo();
?>四、双服务启动与管理
- 启动 PHP FastCGI
# 保持窗口常开
C:\php8\php-cgi.exe -b 127.0.0.1:9000- 启动 Nginx 服务
cd C:\nginx
start nginx- 一键启动脚本
创建start_env.bat：
@echo off
start "PHP-CGI" cmd /k "C:\php8\php-cgi.exe -b 127.0.0.1:9000"
timeout /t 2
start "Nginx" cmd /k "C:\nginx\nginx.exe"五、服务验证与排错
成功标志
访问 http://localhost 访问页面成功
常见问题排查表
| 问题现象 |解决方案 |
|404 Not Found |检查 root 路径是否正确|
|502 Bad Gateway |确认 PHP-CGI 是否在运行|
|空页面无输出 |检查 php.ini 的短标签设置|
六、进阶：注册为系统服务
使用 NSSM 工具实现开机自启：
# 安装 Nginx 服务
nssm install nginx "C:\nginx\nginx.exe"
# 安装 PHP-CGI 服务
nssm install php-cgi "C:\php8\php-cgi.exe" -b 127.0.0.1:9000结语
通过以上步骤，你已经成功搭建了一个高性能的 PHP 本地开发环境。这种配置方式不仅资源占用低，还能与 .NET 9 项目并行运行，非常适合混合技术栈的开发需求。如果在实践中遇到问题，欢迎在评论区留言交流！
文章亮点
- 采用分步截图+代码块的直观展示方式
- 包含环境变量配置等易错细节
- 提供一键启动脚本提升效率
- 通过FAQ表格快速定位问题
希望这篇指南能为您的开发工作带来便利！🚀
