Windows下配置Nginx+PHP环境教程

栗子
栗子
发布时间:2026-10-13| 2人浏览过
原创

在Windows环境下进行Web开发时,经常需要配置基于Nginx和PHP的运行环境。本文将指导您完成从PHP安装到Nginx配置的全过程,包括关键参数的设置以及实现无窗口后台运行的技巧。

准备条件

首先,需要准备PHP的二进制包(如php-cgi.exe)和Nginx的Windows版本安装包。确保下载的是适合Windows系统的二进制文件而非源码。

配置PHP

如果尚未安装PHP,请运行安装包选择“Other CGI”模式,并根据需要启用GD2、MySQL、Mysqli、PDO等相关扩展。安装完成后,PHP即可通过cgi模式提供服务。

启动PHP-CGI服务

目的:以FastCGI方式运行PHP,监听本地请求。
操作:打开命令行工具,进入PHP安装目录。
命令:

php-cgi.exe -b 127.0.0.1:9000

此时会弹出一个命令行窗口显示运行状态,请勿关闭该窗口,否则PHP服务将停止。后续章节将介绍如何隐藏此窗口。

安装与基础配置Nginx

Nginx无需安装程序,解压即用。假设将其解压至D:\nginx-0.7.63。

验证Nginx运行状态

入口:双击nginx.exe。
检查:在浏览器访问 http://localhost/,若看到 Welcome to nginx! 页面,说明Nginx已正常启动。

修改站点根目录

入口:编辑conf\nginx.conf文件。
动作:定位到location / { ... }区块。
参数:

  • root:修改为实际的网站根目录,例如 D:/www。
  • index:添加 index.php 以支持默认主页解析。

修改后的代码片段如下:

location / {
  root  D:/www;
  index index.html index.htm index.php;
}

启用PHP-FastCGI解析

入口:继续在 conf\nginx.conf 中查找被注释的 location ~ \.php$ { ... } 区块。
动作:取消注释并修改路径指向。

  • 保持 fastcgi_pass 127.0.0.1:9000; 不变。
  • root:确保与上方设置的根目录一致(注意原文此处为wwwroot,需根据实际路径统一)。
  • fastcgi_param SCRIPT_FILENAME:这是关键参数,必须修正为当前根目录路径,例如 D:/wwwroot/$fastcgi_script_name; 或 $document_root$fastcgi_script_name;。

完整的启用代码如下:

location ~ \.php$ {
  root      D:/www;
  fastcgi_pass  127.0.0.1:9000;
  fastcgi_index index.php;
  fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
  include    fastcgi_params;
}

注:原文使用了绝对路径 D:/wwwroot,建议根据您的实际项目路径调整,也可使用变量 $document_root 以避免硬编码带来的维护问题。

重新加载配置

操作:配置生效后,重新加载Nginx配置使其生效。
前提:确保 #pid logs/nginx.pid; 这一行的注释已被去除,且 logs 目录下有对应的PID文件。
命令:

nginx -s reload

高级技巧:后台运行与进程管理

直接使用命令行启动PHP-CGI会产生弹窗,且手动关闭进程较为繁琐。以下提供VBS脚本方法和CMD命令。

通过VBS脚本后台启动PHP

目的:静默启动PHP-CGI,不弹出黑色命令行窗口。
操作:在PHP安装目录下新建文本文件,输入以下内容并保存为 start_fastcgi.vbs:

set wscriptObj = CreateObject("Wscript.Shell")
wscriptObj.run "php-cgi.exe -b 127.0.0.1:9000",0

双击运行此VBS文件即可在后台开始工作,且不会遮挡屏幕。

强制结束相关进程

若常规方法无法关闭服务,可使用任务管理器命令强制终止:

  • 停止Nginx:taskkill /F /IM nginx.exe > nul
  • 停止PHP-CGI:taskkill /F /IM php-cgi.exe > nul

检查环境配置

在网站根目录下创建一个包含 <?php phpinfo(); ?> 的PHP文件并访问,可以查看当前PHP和Nginx交互的详细配置信息,用于排错验证。

以上就是在Windows下配置Nginx + PHP的详细内容,更多关于服务器环境搭建的资料请关注本站其它相关文章!

相关标签:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。