window nginx php配置

2026-05-17资讯阅读 1766

Windows下Nginx与PHP环境搭建全攻略

在Windows系统中部署Nginx+PHP环境，常用于本地开发或小型Web项目的快速部署。本文将从准备工作到最终验证，详细讲解配置流程，帮助开发者快速上手。

一、准备工作：环境与软件选择

Windows环境需满足以下要求：

系统版本：Windows 10/11或Windows Server 2019+（推荐64位系统）
依赖组件：需安装Microsoft Visual C++ 2015-2022 Redistributable（Nginx和PHP运行库）

下载必要软件：

Nginx：从官网下载Windows版本（推荐稳定版，如Nginx 1.24.0）
PHP：选择“Windows Downloads”中的非线程安全版（TS或NTS），推荐PHP 8.2+版本

二、安装与基础配置Nginx

1. 解压Nginx

将下载的Nginx压缩包解压至指定目录（如C:\nginx），目录结构如下：

nginx/
├─ conf/        # 配置文件目录
├─ html/        # 默认网站根目录
├─ logs/        # 日志目录
└─ nginx.exe    # 主程序

2. 启动与测试Nginx

打开命令提示符（管理员权限），进入Nginx目录执行：

nginx.exe

此时访问 http://localhost，若显示Nginx欢迎页面，则安装成功。

三、安装与配置PHP

1. 解压PHP

将PHP压缩包解压至C:\php目录，确保路径不含空格或中文。

2. 配置php.ini

复制php.ini-development为php.ini，并修改关键参数：

设置时区：date.timezone = Asia/Shanghai
启用扩展：取消extension=mysqli、extension=pdo_mysql等扩展前的分号（需确保扩展文件存在）
错误日志：error_log = C:/php/php_errors.log（路径为正斜杠）

四、配置Nginx与PHP联动

1. 启动PHP-FPM

Windows下PHP通过php-cgi.exe提供FastCGI服务，需在命令行启动：

cd C:\php
php-cgi.exe -b 127.0.0.1:9000 -c C:\php\php.ini

此命令会启动PHP-CGI进程并监听9000端口（-b指定监听地址，-c指定配置文件）。

2. 配置Nginx处理PHP请求

编辑C:\nginx\conf\nginx.conf，在server块中添加以下配置：

location ~ \.php$ {
    fastcgi_pass   127.0.0.1:9000;       # 指向PHP-FPM进程
    fastcgi_index  index.php;
    fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
    include        fastcgi_params;
}

保存后执行nginx.exe -s reload重载配置。

五、测试验证环境

1. 创建测试文件

在Nginx根目录C:\nginx\html下新建phpinfo.php，内容如下：

<?php phpinfo(); ?>

2. 访问验证

重启Nginx和PHP服务后，访问 http://localhost/phpinfo.php。若页面显示PHP版本、环境变量等信息，且MySQL等扩展正常加载，则配置成功。

六、常见问题与解决

502 Bad Gateway：
- 检查PHP-FPM是否启动（任务管理器中确认php-cgi.exe进程存在）
- 确认fastcgi_pass端口与PHP-FPM监听端口一致（默认9000）
404 Not Found：
- 检查Nginx配置中root路径是否正确（如root html;对应C:\nginx\html）
- 确保SCRIPT_FILENAME路径包含正确的文件位置