在Windows系统中运行PHP需要完成安装包下载、环境配置、文件调整等多个步骤，整体流程并不复杂，按照规范操作就能快速搭建可用的运行环境。
Windows系统PHP配置完整指南：从零搭建本地运行环境
一、前言：为什么要在Windows上搭建PHP环境
对于很多刚接触PHP开发的朋友来说，第一步往往不是写代码，而是把运行环境搭起来。和Linux服务器上通常预装了PHP不同，Windows系统本身并不包含PHP运行所需的任何组件，一切都需要我们手动配置。
你可能会问，为什么不直接用集成环境？确实，像phpStudy、WAMP、XAMPP这类一键集成工具非常方便，但作为开发者，了解PHP在Windows上是如何一步步跑起来的，对于后续排查问题、理解Web服务器工作原理都大有裨益。而且在某些公司内网环境下，安装第三方集成软件可能受到限制，这时候手动配置的能力就显得尤为重要了。
本文将从PHP安装包下载开始，一步步带你完成环境变量配置、php.ini核心调整、搭配服务器运行以及常见问题排查，确保你在Windows系统上拥有一个完整可用的PHP开发环境。无论你是准备学习PHP语法、开发个人项目，还是需要在本地调试公司代码，这篇指南都能帮到你。
二、下载PHP安装包
2.1 选择正确的版本
PHP官方网站的Windows版本下载页面（windows.php.net/download）提供了多个版本供选择。对于新手来说，这里最容易犯的错误就是选错了版本。
首先看PHP的大版本号。截至目前，PHP 8.2和8.3是主流选择，如果你是新项目，建议直接选择PHP 8.2或更高版本，性能和语法特性都更好。如果是维护老项目，可能需要选择PHP 7.4甚至更早的版本，具体取决于项目要求。
其次要注意线程安全（Thread Safe，简称TS）和非线程安全（Non Thread Safe，简称NTS）的区别。如果你打算搭配Apache服务器使用，必须选择线程安全版本，因为Apache是以多线程模式运行的，需要PHP的线程安全支持。如果你只用PHP内置服务器或者搭配Nginx（通过FastCGI方式），可以选择非线程安全版本。对于初学者，建议直接下载线程安全版本，这样无论后续搭配什么服务器都不会出问题。
另外，根据你的Windows系统架构选择x64（64位）或x86（32位）。现在绝大多数电脑都是64位系统，选择x64版本即可。下载的文件通常是一个ZIP压缩包，体积在20MB到30MB左右。
2.2 解压到合适的位置
下载完成后，将ZIP包解压到你希望放置PHP的目录。建议选择一个路径简单、不含中文和空格的目录，比如D:\php或C:\php。不要解压到桌面或者下载文件夹里，因为后续配置环境变量和php.ini时都需要引用这个路径，路径中如果有中文或空格，可能会导致一些莫名其妙的问题。
解压后打开目录，你会看到一系列文件和文件夹。其中比较重要的有：php.exe（PHP的命令行执行程序）、php.ini-development（开发环境配置模板）、php.ini-production（生产环境配置模板）、ext文件夹（存放各种扩展模块）。解压后的目录结构一定要保持完整，不要随意删除任何文件或文件夹，否则后续运行时可能会报缺少模块的错误。
三、配置环境变量
3.1 为什么要配置环境变量
配置环境变量的核心目的只有一个：让你可以在任意目录下直接执行php命令，而不需要每次都切换到PHP的安装目录。
打个比方，如果你没有配置环境变量，想在D盘某个项目目录下执行PHP脚本，你就得输入完整路径D:\php\php.exe test.php。但配置好环境变量后，只需要输入php test.php就行了。对于日常开发来说，这种便利性是不可或缺的。
更重要的是，很多开发工具（比如Composer、PHPStorm、VS Code的PHP插件）在运行时都会依赖系统能直接找到php命令。如果环境变量没配好，这些工具就无法正常工作。
3.2 详细配置步骤
下面以Windows 10和Windows 11系统为例，逐步说明如何配置环境变量：
第一步，右键点击桌面上的"此电脑"（或"我的电脑"）图标，选择"属性"。在打开的设置页面中，找到并点击"高级系统设置"（通常在页面右侧或左侧），这时会弹出"系统属性"窗口。
第二步，在"系统属性"窗口的"高级"选项卡右下角，点击"环境变量"按钮。这时会打开"环境变量"管理窗口，窗口分为上下两部分：上半部分是"用户变量"（仅对当前登录用户生效），下半部分是"系统变量"（对所有用户生效）。建议将PHP路径添加到"系统变量"的Path中，这样如果电脑有多个用户账号，每个账号都能使用PHP命令。
第三步，在"系统变量"区域找到名为Path的变量（注意大小写不敏感，有的系统显示为PATH），选中它并点击"编辑"按钮。在弹出的编辑窗口中，点击"新建"按钮，然后输入PHP的解压目录路径，比如D:\php。确认路径输入无误后，一路点击"确定"关闭所有窗口。
第四步，验证配置是否成功。打开一个新的命令提示符窗口（注意：如果配置前已经打开了CMD窗口，需要先关闭再重新打开，否则不会加载新的环境变量），输入以下命令：
php -v如果配置正确，你会看到类似这样的输出：
PHP 8.2.15 (cli) (built: Jan 17 2024 15:22:33) (ZTS Visual C++ 2019 x64)
Copyright (c) The PHP Group
Zend Engine v4.2.15, Copyright (c) Zend Technologies这说明PHP已经可以在任意目录下被系统识别了。如果提示"php不是内部或外部命令"，请检查Path中填写的路径是否正确，以及是否重新打开了CMD窗口。
四、调整php.ini配置文件
4.1 php.ini是什么
php.ini是PHP的核心配置文件，PHP运行时的几乎所有行为都可以通过这个文件来控制。比如最大上传文件大小、是否显示错误信息、时区设置、开启哪些扩展模块等等。
PHP解压目录中默认提供了两个配置模板文件：php.ini-development和php.ini-production。前者适合开发环境，开启了错误显示、关闭了部分性能优化，方便调试；后者适合生产服务器，关闭了错误显示、开启了OPcache等性能优化，安全性更高。我们本地开发直接复制php.ini-development即可。
具体操作是：将php.ini-development复制一份，重命名为php.ini，放在同一个目录下。PHP在启动时会自动在当前目录寻找这个文件。
4.2 必须调整的核心配置项
用记事本或任何文本编辑器打开php.ini，我们需要修改以下几个关键配置：
设置扩展目录
找到这一行：
;extension_dir = "ext"去掉行首的分号（分号在PHP配置中表示注释），并将其修改为实际的ext目录路径：
extension_dir = "D:\php\ext"注意这里的路径要和你解压PHP的实际目录一致。这个配置告诉PHP去哪里找扩展模块文件（.dll文件），如果路径不对，所有扩展都无法加载。
开启常用扩展
PHP的很多功能是以扩展形式提供的，默认情况下大部分扩展都是关闭的。你需要根据项目需求手动开启。常见的扩展包括：
extension=mysqli—— 用于操作MySQL数据库（面向过程+面向对象风格）extension=pdo_mysql—— PDO方式操作MySQL，现代PHP项目几乎必备extension=gd或extension=gd2—— 图像处理功能extension=curl—— 发起HTTP请求extension=openssl—— 加密通信、HTTPS支持extension=mbstring—— 多字节字符串处理，处理中文必备
开启方法很简单，找到对应的行，去掉前面的分号即可。比如：
extension=mysqli
extension=pdo_mysql
extension=curl
extension=openssl
extension=mbstring设置时区
找到这一行：
;date.timezone =去掉分号，设置为中国时区：
date.timezone = Asia/Shanghai如果不设置时区，PHP在使用date()、time()等时间相关函数时会报一个警告，而且返回的时间会是UTC时间（比北京时间晚8小时），这在开发中会造成很多困扰。
调整错误报告级别
在开发环境中，建议将错误信息全部显示出来，方便排查问题。找到error_reporting和display_errors两行，确保设置如下：
error_reporting = E_ALL
display_errors = On这样PHP会把所有级别的错误、警告、通知都显示在页面上。
修改完成后保存文件。配置会在下一次执行PHP命令或重启Web服务器时生效。
五、搭配本地服务器运行PHP
5.1 使用PHP内置服务器（最简单的方式）
PHP从5.4版本开始自带了一个简易的开发服务器，非常适合本地快速测试。不需要安装Apache或Nginx，一条命令就能启动。
打开命令提示符，切换到你存放PHP项目的目录。比如你的项目文件在D:\php_project目录下，就先切换过去：
cd D:\php_project然后执行以下命令启动服务器：
php -S localhost:8080这条命令的含义是：启动PHP内置服务器，监听本机的8080端口。执行后你会看到类似这样的提示：
PHP 8.2.15 Development Server started at http://localhost:8080
Press Ctrl-C to quit.现在打开浏览器，访问http://localhost:8080，服务器会自动寻找目录下的index.php文件。如果不存在index.php，会列出目录文件列表。
为了验证PHP是否正常工作，在D:\php_project目录下创建一个test.php文件，内容如下：
<?php
// 输出PHP信息，验证环境是否正常
phpinfo();
?>然后在浏览器中访问http://localhost:8080/test.php。如果看到一个包含了PHP版本、配置信息、已加载扩展等详细内容的紫色页面，恭喜你，PHP环境已经完全搭建成功。
5.2 搭配Apache服务器运行
如果你需要更完整的Web服务器功能（比如URL重写、虚拟主机、.htaccess支持等），可以安装Apache并与之搭配。
首先需要下载Apache的Windows版本（可以从Apache Lounge网站获取）。安装完成后，修改Apache的配置文件httpd.conf，添加PHP模块支持：
LoadModule php_module "D:/php/php8apache2_4.dll"
AddHandler application/x-httpd-php .php
PHPIniDir "D:/php"然后在Apache的配置中设置项目目录：
DocumentRoot "D:/php_project"
<Directory "D:/php_project">
AllowOverride All
Require all granted
</Directory>重启Apache后，就可以通过http://localhost直接访问PHP项目了，不需要指定端口号。
5.3 使用虚拟主机绑定自定义域名
如果你希望像线上环境一样用域名访问本地项目，可以配置Apache的虚拟主机。在httpd-vhosts.conf中添加：
<VirtualHost *:80>
ServerName www.pcppp.com
DocumentRoot "D:/php_project"
<Directory "D:/php_project">
AllowOverride All
Require all granted
</Directory>
</VirtualHost>然后在Windows的hosts文件中添加一行（hosts文件路径为C:\Windows\System32\drivers\etc\hosts）：
127.0.0.1 www.pcppp.com保存后刷新DNS缓存（执行ipconfig /flushdns），就可以通过http://www.pcppp.com访问你的PHP项目了。这种方式特别适合需要模拟线上域名环境的开发场景。
六、常见问题排查
6.1 php -v命令无反应或提示不是内部命令
这个问题99%是环境变量配置有误。请按以下步骤排查：
第一，确认Path中添加的路径是否和PHP实际解压目录完全一致，包括盘符和大小写（虽然Windows不区分大小写，但路径必须存在）。第二，确认php.exe文件确实存在于该目录下。第三，确认修改环境变量后是否重新打开了CMD窗口。第四，如果Path中有多条记录，检查是否有其他程序占用了php命令名。
还有一个容易被忽略的情况：如果你使用的是PowerShell而不是CMD，有时需要重启PowerShell窗口才能加载新的环境变量。
6.2 浏览器访问PHP文件提示"File not found"
使用PHP内置服务器时，这个错误通常有两个原因：一是启动服务器时所在的目录不对，确保你是在项目根目录下执行的php -S命令；二是浏览器中访问的文件名拼写错误，或者文件确实不存在于该目录中。
如果使用Apache，还需要检查DocumentRoot配置是否正确，以及项目目录下是否有对应的文件。
6.3 PHP扩展不生效
扩展不生效的排查步骤：首先确认php.ini中extension_dir的路径是否正确指向了ext目录；其次确认扩展名前面的分号已经去掉；第三，确认PHP目录下ext文件夹中确实存在对应的.dll文件（比如开启mysqli扩展，ext目录中应该有php_mysqli.dll）；第四，有些扩展之间有依赖关系，比如pdo_mysql依赖pdo扩展，需要确保extension=pdo也开启了。
你可以通过php -m命令查看当前已加载的模块列表，确认你需要的扩展是否在其中。
6.4 访问页面时中文乱码
这通常不是PHP的问题，而是字符编码设置不一致导致的。确保你的PHP文件本身保存为UTF-8编码（无BOM格式），在PHP代码开头设置响应头：
header('Content-Type: text/html; charset=utf-8');同时，如果你在输出数据库内容时乱码，还需要确保数据库连接也设置了UTF-8编码。
6.5 修改php.ini后不生效
修改php.ini后，如果你是通过浏览器访问PHP（搭配Apache或Nginx），需要重启Web服务器才能加载新的配置。如果是通过命令行执行PHP脚本，新的CMD窗口会自动读取最新的php.ini。可以通过phpinfo()页面中的"Loaded Configuration File"一项确认PHP实际加载的是哪个php.ini文件，有时候系统上可能存在多个php.ini，修改错了位置就不会生效。
七、总结
在Windows系统上搭建PHP运行环境，核心步骤就是：下载正确的安装包→配置环境变量→调整php.ini→搭配服务器运行。每一步都不复杂，但细节决定成败，特别是路径配置和扩展开启这两个环节，稍有不慎就会导致运行异常。
手动搭建环境虽然比一键集成工具多了几个步骤，但它让你对整个PHP运行机制有了更清晰的认识。当你后续遇到"为什么这个扩展加载不了"、"为什么时区不对"、"为什么命令行能跑浏览器跑不了"这类问题时，你就能快速定位原因，而不是一头雾水。
最后提醒一点：本文中提到的所有路径（如D:\php、D:\php_project）都是示例，请根据你自己的实际情况替换为真实路径。如果在操作过程中遇到任何问题，欢迎按照第六节的排查思路逐一检查，大部分问题都能迎刃而解。祝你PHP开发之路顺利！