Windows下PHP环境搭建：Nginx+PHP-FPM手动配置全攻略

1. 项目概述：为什么要在Windows上运行PHP？

很多朋友一提到PHP开发，脑子里蹦出来的第一反应可能就是Linux服务器、Nginx或者Apache。确实，PHP在Linux环境下如鱼得水，但现实情况是，我们日常办公、学习的主力机，绝大多数还是Windows系统。无论是前端同学想快速搭建一个本地环境来调试接口，还是后端开发者需要在个人电脑上验证某个功能，亦或是学生党想学习PHP却苦于没有服务器，在Windows上安装并运行PHP都是一个非常实际且高频的需求。

这个需求看似简单，不就是下载、安装、运行吗？但实际操作起来，新手往往会遇到各种“拦路虎”：环境变量配置不对导致命令行里找不到php命令；扩展没开，连个简单的mysqli连接都报错；或者想用Composer管理依赖，却发现根本调用不了。更别提还有IIS、Apache、Nginx等多种Web服务器可选，搭配起来更是让人眼花缭乱。今天，我就以一个过来人的身份，带你从头到尾、清清楚楚地在Windows上把PHP环境给“盘”顺了。我们不追求最“炫技”的方式，只追求最稳定、易懂、可复现的路径，让你在Windows上运行PHP像打开记事本一样自然。

2. 环境准备与核心工具选型

在Windows上搭建PHP环境，本质上是在组合三个核心部件：PHP解释器本身、一个Web服务器、以及一个数据库（可选，但通常需要）。我们的目标是把它们有机地整合起来，让它们能协同工作。

2.1 PHP解释器的选择与下载

首先，我们需要PHP的“发动机”——解释器。去PHP官网的Windows版本下载页面，你会看到很多版本和线程安全（Thread Safe, TS）与非线程安全（Non-Thread Safe, NTS）的选择。这里有个关键决策点：

TS vs NTS，到底选哪个？这取决于你计划搭配哪种Web服务器。

• 如果你计划使用IIS，或者使用Apache的mod_php模块方式运行，请选择TS版本。因为IIS和Apache的某些运行模式是多线程的，需要线程安全的PHP来保证稳定。
• 如果你计划使用Nginx，或者Apache以FastCGI模式运行（推荐），请选择NTS版本。Nginx本身通过PHP-FPM（一个FastCGI进程管理器）与PHP通信，这个模式下PHP以独立的进程运行，互不干扰，NTS版本性能稍好，也更稳定。

对于绝大多数本地开发环境，我强烈推荐Nginx + PHP-FPM (NTS)的组合，轻量、高效、配置清晰。因此，我们下载PHP 8.x NTS版本。

注意：下载时选择“Zip”压缩包，而不是安装程序（Installer）。Zip包更纯净，也方便我们手动管理。

2.2 Web服务器的抉择：Nginx vs Apache

在Windows上，我们主要有两个选择：老牌的Apache和轻量的Nginx。

• Apache：功能强大，模块丰富，.htaccess文件配置灵活，但配置相对复杂，资源占用稍高。
• Nginx：以高并发、低内存占用闻名，配置文件简洁明了，反向代理功能强大。对于本地开发，特别是需要模拟现代生产环境（很多公司用Nginx），它是更好的选择。

从易用性和性能出发，本次我们选择Nginx。同样，去Nginx官网下载Windows版本的稳定版Zip包即可。

2.3 数据库选型：MySQL/MariaDB

虽然PHP环境可以没有数据库，但几乎99%的项目都会用到。在Windows上，最方便的是使用MariaDB或MySQL的官方安装包。MariaDB是MySQL的一个分支，完全兼容，且在一些方面有优化。你可以任选其一，安装过程都是图形化的，非常友好。记得安装时设置好root用户的密码。

2.4 集成环境包的利与弊

你可能会问：为什么不直接用XAMPP、WampServer这类集成环境？一键安装多省事。 集成环境确实适合绝对新手快速搭建。但它是一把“双刃剑”：

• 优点：开箱即用，无需手动配置。
• 缺点：
  1. 黑盒化：它帮你做了所有事，但你不知道背后原理。一旦出问题，排查极其困难。
  2. 版本固化：PHP、MySQL、Apache的版本被捆绑，你想单独升级其中一个很麻烦。
  3. 灵活性差：自定义扩展、修改核心配置不如手动安装方便。

为了真正掌握环境，我建议从手动配置开始。这就像学开车，不能永远用自动驾驶模式。

3. 手动安装与配置全流程解析

现在，我们开始动手。假设我们把所有软件都安装在D:\DevEnv目录下，这样便于管理。

3.1 PHP解释器的部署与基础配置

1. 解压与放置：将下载的PHP NTS Zip包（例如php-8.2.10-nts-Win32-vs16-x64.zip）解压到D:\DevEnv\php。现在你的D:\DevEnv\php目录下应该有php.exe、php.ini-development等文件。
2. 配置核心文件php.ini：在D:\DevEnv\php目录下，找到php.ini-development文件，复制一份并重命名为php.ini。这个文件就是PHP的主配置文件。用记事本或VS Code打开它，我们需要修改几个关键地方：
   • 设置扩展目录：找到;extension_dir = "ext"这一行，去掉前面的分号;（分号是注释符），并确保路径正确。通常改为extension_dir = "D:\DevEnv\php\ext"。
   • 启用常用扩展：找到下面这些行，去掉前面的分号来启用扩展。这是让PHP支持MySQL、Redis、GD库等功能的开关。

     extension=curl extension=fileinfo extension=gd extension=mbstring extension=mysqli extension=openssl extension=pdo_mysql

   • 设置时区：找到;date.timezone =，去掉分号并设置为你的时区，例如date.timezone = Asia/Shanghai。
   • 开启错误显示（仅限开发环境）：为了方便调试，找到display_errors和error_reporting相关设置，确保在开发时能显示错误信息。生产环境务必关闭！

     display_errors = On error_reporting = E_ALL

3. 配置系统环境变量：这是让系统在任何位置都能识别php命令的关键。
   • 右键点击“此电脑” -> “属性” -> “高级系统设置” -> “环境变量”。
   • 在“系统变量”部分，找到并选中Path变量，点击“编辑”。
   • 点击“新建”，添加PHP的安装路径：D:\DevEnv\php。
   • 一路点击“确定”保存。

验证PHP安装：打开一个新的命令提示符（CMD）或PowerShell窗口，输入php -v并回车。如果看到类似“PHP 8.2.10 (cli) ...”的版本信息，恭喜你，PHP解释器安装成功了！再输入php -m可以查看已加载的模块，确认mysqli、pdo_mysql等扩展是否在列表中。

3.2 Nginx服务器的配置与启动

1. 解压与放置：将Nginx的Zip包解压到D:\DevEnv\nginx。

2. 关键配置nginx.conf：用编辑器打开D:\DevEnv\nginx\conf\nginx.conf文件。我们需要修改server块，让它能处理PHP请求。

   • 找到location / { ... }块，这是处理静态文件的。
   • 我们需要添加一个location块来处理.php结尾的请求，并将它们转发给PHP-FPM处理。通常在index指令下面添加：

   location ~ \.php$ { root html; # 这里对应你的网站根目录，默认是nginx目录下的html文件夹 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; }

   • 同时，修改index指令，把index.php加进去：index index.html index.php;

3. 启动与测试Nginx：

   • 打开CMD，进入Nginx目录：cd /d D:\DevEnv\nginx。
   • 启动Nginx：start nginx。这个命令会静默启动，没有成功提示是正常的。
   • 打开浏览器，访问http://localhost。如果看到“Welcome to nginx!”的页面，说明Nginx启动成功。
   • 停止Nginx：nginx -s stop。重新加载配置（修改conf文件后）：nginx -s reload。

3.3 启动PHP-FPM进程管理器

PHP-FPM是Nginx和PHP之间的“翻译官”。在PHP 8.x的Windows版中，FPM程序已经包含在Zip包里了。

1. 配置PHP-FPM：在D:\DevEnv\php目录下，找到php.ini的同级目录，应该有一个php-fpm.conf文件（如果没有，可以复制php-fpm.conf.development并重命名）。通常默认配置即可，但需要确认listen设置与Nginx配置中的fastcgi_pass一致。默认是listen = 127.0.0.1:9000。
2. 启动PHP-FPM：
   • 打开一个新的CMD窗口，进入PHP目录：cd /d D:\DevEnv\php。
   • 启动FPM：php-cgi.exe -b 127.0.0.1:9000 -c php.ini。注意，在Windows上，我们通常用php-cgi配合-b参数来模拟FPM的功能。真正的php-fpm.exe在Windows上可能不太稳定。
   • 这个窗口会一直运行，不要关闭它。它表示PHP-FPM服务正在监听9000端口。

3.4 创建测试文件验证环境

现在，让Nginx和PHP-FPM“握手”。

1. 在Nginx的网站根目录（默认是D:\DevEnv\nginx\html）下，新建一个文件，命名为info.php。
2. 用记事本打开，输入以下内容并保存：

   <?php phpinfo(); ?>

3. 确保Nginx和PHP-FPM（即运行着php-cgi命令的窗口）都在运行。
4. 打开浏览器，访问http://localhost/info.php。

如果一切顺利，你将看到一个非常详细的、包含了PHP所有配置信息的页面。在这个页面上，你可以搜索“mysqli”、“PDO”来确认数据库扩展已加载，搜索“Server API”可以看到是“FPM/FastCGI”。看到这个页面，就意味着你的Windows PHP运行环境已经完全打通了！

4. 进阶配置与日常使用技巧

环境跑通了，但要想用得顺手，还需要一些“打磨”。

4.1 自定义网站根目录与虚拟主机

你肯定不想把所有项目都扔在nginx\html下。我们可以配置一个自定义的目录，比如D:\www。

1. 修改Nginx配置：打开nginx.conf，找到server块里的root指令，以及我们之前添加的PHPlocation块里的root，将它们都改为你的新路径，例如root D:\www;。
2. 创建项目：在D:\www下新建一个文件夹myproject，在里面创建index.php。
3. 配置虚拟主机（可选但推荐）：如果你想用域名（如myproject.test）访问，而不是localhost/myproject，需要配置虚拟主机。这涉及到修改Windows的hosts文件（C:\Windows\System32\drivers\etc\hosts，用管理员权限编辑），添加一行127.0.0.1 myproject.test，并在Nginx里为这个域名单独配置一个server块。

4.2 使用Composer管理PHP依赖

Composer是PHP的包管理器，现代开发离不开它。在Windows上安装Composer非常简单：

1. 访问Composer官网，下载Windows安装程序Composer-Setup.exe。
2. 运行安装程序，在选择PHP路径时，指向我们手动安装的PHP：D:\DevEnv\php\php.exe。
3. 安装完成后，打开新的CMD，输入composer --version验证。

现在，你可以在任何项目目录下使用composer require来安装依赖包了，例如composer require monolog/monolog。

4.3 将Nginx和PHP-FPM注册为系统服务（实现开机自启）

每次开机都要手动打开两个CMD窗口来启动Nginx和PHP-FPM太麻烦了。我们可以使用一个叫nssm（Non-Sucking Service Manager）的小工具将它们注册为Windows系统服务。

1. 下载nssm，将nssm.exe放到一个方便的地方，比如D:\DevEnv。
2. 以管理员身份打开CMD，安装Nginx服务：

   nssm install Nginx "D:\DevEnv\nginx\nginx.exe"

   在弹出的GUI窗口中，可以设置服务名、描述等，通常直接点击“Install service”即可。
3. 安装PHP-FPM服务（这里我们用php-cgi）：

   nssm install PHP-FPM "D:\DevEnv\php\php-cgi.exe"

   在参数（Arguments）一栏，填写：-b 127.0.0.1:9000 -c D:\DevEnv\php\php.ini。
4. 安装完成后，打开“服务”应用（services.msc），找到“Nginx”和“PHP-FPM”服务，将它们设置为“自动”启动并立即启动它们。

这样，你的PHP开发环境就实现了开机自启，一劳永逸。

5. 常见问题排查与解决实录

手动配置环境，遇到问题是常态。这里记录几个我踩过的坑和解决方法。

5.1 访问.php文件直接下载或显示源码

问题现象：浏览器访问info.php，结果不是显示PHP信息页，而是弹出下载对话框，或者直接显示了<?php phpinfo(); ?>这段源代码。排查思路：这几乎100%是Nginx没有正确将PHP请求转发给PHP-FPM。

1. 检查Nginx配置：确认nginx.conf中处理PHP的location块配置正确，特别是fastcgi_pass 127.0.0.1:9000;这一行。
2. 检查PHP-FPM是否运行：在CMD中输入netstat -ano | findstr :9000，查看9000端口是否有程序在监听。如果没有，说明PHP-FPM没启动成功，回去检查启动命令和PHP配置文件。
3. 检查路径：确认fastcgi_param SCRIPT_FILENAME后面定义的路径$document_root$fastcgi_script_name能正确拼接出PHP文件的绝对路径。有时需要写为绝对路径，如fastcgi_param SCRIPT_FILENAME D:/www$fastcgi_script_name;。

5.2 PHP扩展未加载，调用函数报错

问题现象：代码里使用mysqli_connect()或PDO时，报错“Call to undefined function...”。排查思路：

1. 确认扩展已启用：在php.ini中检查对应的extension=php_mysqli.dll等行是否已去掉分号。
2. 检查扩展文件是否存在：去D:\DevEnv\php\ext目录下看看，是否存在php_mysqli.dll文件。如果没有，可能是你下载的PHP版本不包含这个扩展，需要换一个版本或自己编译。
3. 查看已加载模块：在CMD中运行php -m，查看输出列表中是否有mysqli、pdo_mysql等。如果没有，说明扩展加载失败。检查php.ini中extension_dir的路径是否正确，以及PHP是否加载了你修改后的那个php.ini文件（可以通过php --ini命令查看加载的配置文件路径）。

5.3 端口冲突导致服务启动失败

问题现象：启动Nginx或PHP-FPM时，提示“bind() to 0.0.0.0:80 failed”或“address already in use”。排查思路：80端口（Nginx默认）或9000端口（PHP-FPM默认）被其他程序占用了。

1. 查找占用端口的进程：在CMD中运行：
   • 对于80端口：netstat -ano | findstr :80
   • 对于9000端口：netstat -ano | findstr :9000记下最后一列的PID（进程ID）。
2. 结束进程或修改配置：
   • 打开任务管理器，在“详细信息”选项卡里，根据PID找到对应的进程。如果是Skype、IIS、SQL Server Reporting Services等，可以考虑关闭它们，或者修改Nginx的监听端口（在nginx.conf中将listen 80;改为listen 8080;，然后访问http://localhost:8080）。
   • 如果是未知进程，需要谨慎判断。对于PHP-FPM的9000端口，也可以在其配置文件中修改listen的值，并同步修改Nginx的fastcgi_pass。

5.4 文件权限问题导致写入失败

问题现象：PHP程序运行时报错，提示无法创建文件、无法写入日志等。排查思路：在Windows上，虽然不像Linux有严格的用户组权限，但依然存在权限问题，尤其是当Web服务器（Nginx）以系统服务运行时。

1. 检查文件夹权限：右键点击PHP程序需要写入的目录（如日志目录logs、文件上传目录uploads），选择“属性” -> “安全”选项卡。
2. 添加写入权限：点击“编辑”，然后“添加”，在对象名称中输入IIS_IUSRS（如果使用IIS）或NETWORK SERVICE（如果Nginx服务以此账户运行），或者更简单直接添加Everyone（仅限本地开发环境！），并赋予“修改”和“写入”权限。点击确定应用。

手动配置环境的过程，就是一个不断遇到问题、搜索、尝试、解决并加深理解的过程。每一次成功的排错，都会让你对这套系统的运作方式有更深刻的认识。当你在Windows上流畅地运行起自己的PHP项目时，那份成就感，是使用集成环境包无法比拟的。这套手动搭建的环境，其灵活性、可控性和对你的知识提升，将成为你后续开发工作中非常扎实的基础。