Windows 11 安装 PHP 的详细过程,以及环境变量应该如何配置
发布时间:
2026-08-23 07:00:02
最后更新:
2026-08-23 08:06:16
阅读:6 约8 分钟阅读
【中国观察北京时间2026年08月15日】【中国观察北京时间2026年08月15日】
在 Windows 11 上安装 PHP,并不意味着必须同时安装 Apache、MySQL 或其他软件。PHP 本身可以作为命令行程序运行,也可以之后再与 Apache、IIS 或其他 Web 服务器结合使用。
因此,安装 PHP 最适合分成两个阶段理解:先把 PHP 本身安装好,并让 Windows 能够通过命令行找到它;确认 PHP 正常以后,再根据项目需要配置 Web 服务器和数据库。
一、先确定需要什么版本的 PHP
PHP 官方为 Windows 提供预编译版本。下载时首先需要根据自己的系统和运行方式选择合适的版本。
目前常见的 Windows 电脑通常是 64 位系统,因此一般选择 x64 构建版本。
另外还需要注意 PHP 的 Thread Safe 和 Non Thread Safe 两类构建。
如果只是准备在 Windows 命令行中运行 PHP,或者之后通过 FastCGI 等方式运行,选择哪一种需要结合具体的 Web 服务器配置。不能简单认为 Thread Safe 一定比 Non Thread Safe 更好。
如果只是学习 PHP,建议先不要同时考虑 Apache、IIS、数据库等问题。先安装 PHP CLI,确认 PHP 本身能够正常运行,再继续配置其他组件。
二、下载 PHP
PHP 官方 Windows 下载页面提供对应版本的压缩包。
下载以后不需要使用传统意义上的安装向导。PHP Windows版本通常采用解压方式部署。
例如可以建立:
C:\php
然后将下载的 PHP 压缩包解压到这个目录。
最终应该能够看到类似:
C:\php\php.exe
C:\php\php.ini-development
C:\php\php.ini-production
其中最重要的是 `php.exe`。
它就是Windows下运行PHP命令的主要程序。
三、为什么建议使用简单的安装目录
PHP可以放在其他磁盘和目录,例如:
D:\PHP
E:\dev\php
并没有规定必须安装到 `C:\php`。
不过对于初学者来说,路径越简单越容易排查问题。
例如:
C:\php
比:
C:\Users\用户名\Documents\开发工具\PHP\某个版本\
更容易配置环境变量,也更方便在命令行中检查。
需要注意的是,PHP所在目录本身并不等于网站根目录。
PHP只是程序运行环境,而网站项目可以放在其他位置。
四、准备 php.ini
PHP压缩包通常不会直接提供一个已经命名为 `php.ini` 的配置文件,而是提供开发环境和生产环境的示例配置。
常见文件包括:
php.ini-development
php.ini-production
如果是本地开发环境,可以复制:
php.ini-development
并将副本命名为:
php.ini
例如最终目录变成:
C:\php\php.ini
PHP启动时会根据配置查找规则加载配置文件。
之后可以使用:
php --ini
检查当前命令行PHP到底加载了哪个配置文件。
这一点非常重要,因为很多PHP问题并不是 `php.ini` 写错,而是修改了一个PHP根本没有加载的配置文件。
五、配置 Windows 环境变量
PHP安装完成以后,下一步是让Windows能够在任何目录执行:
php
而不是每次都输入完整路径:
C:\php\php.exe
这就是环境变量 PATH 的作用。
PATH本质上是一组目录。
当你在命令提示符中输入:
php
Windows会按照PATH中的目录寻找对应的可执行文件。
因此,我们需要把PHP目录:
C:\php
加入PATH。
注意:加入PATH的是:
C:\php
而不是:
C:\php\php.exe
因为PATH保存的是用于寻找程序的目录。
六、Windows 11 中如何修改 PATH
在Windows 11中,可以通过系统搜索找到:
**编辑系统环境变量**
然后打开系统属性中的环境变量设置。
在环境变量窗口中,可以看到用户变量和系统变量。
如果只希望当前Windows账户使用PHP,可以修改用户变量中的 `Path`。
如果希望系统中的多个用户都能够使用,则可以配置系统变量中的 `Path`。
选择 `Path` 后点击编辑,然后新增:
C:\php
保存所有设置。
现代Windows环境变量编辑器可以将不同目录作为独立条目保存,因此不需要按照一些老教程那样手动在路径前面添加分号。
这也是一个容易被旧教程误导的地方。
七、重新打开命令提示符
修改PATH以后,已经打开的命令提示符窗口不一定能够立即看到新的环境变量。
因此建议关闭原来的CMD或PowerShell窗口,再重新打开。
然后执行:
php -v
如果配置正确,应该看到PHP版本信息。
这说明Windows已经能够通过PATH找到 `php.exe`。
还可以使用:
where php
查看Windows实际找到的是哪个PHP程序。
例如如果结果显示:
C:\php\php.exe
说明当前命令使用的就是这个PHP。
八、为什么 php -v 很重要
很多初学者看到浏览器能够打开网站,就认为PHP环境已经配置完成。
实际上需要区分不同运行环境。
执行:
php -v
测试的是命令行PHP。
执行:
php --ini
测试的是命令行PHP当前使用的配置文件。
执行:
php -m
可以查看当前加载的PHP扩展。
这些命令可以帮助我们把问题分开。
例如:
php -v
正常,但:
php -m
缺少项目需要的扩展,那么问题就不是PATH,而是PHP扩展配置。
九、检查 PHP 扩展
PHP本身提供大量扩展,用于连接数据库、处理图片、字符串、网络请求等功能。
可以执行:
php -m
查看已经加载的模块。
还可以使用:
php -i
查看更加完整的PHP运行信息。
如果项目需要某个扩展,首先应该确认当前PHP版本是否已经提供对应扩展,然后再根据实际情况修改 `php.ini`。
不要看到网上教程要求打开某个DLL,就直接照抄。扩展必须与PHP版本、系统架构以及PHP构建类型相匹配。
十、检查 php.ini 是否真正生效
执行:
php --ini
重点查看:
Loaded Configuration File
它告诉你当前CLI PHP实际加载的是哪个 `php.ini`。
如果这里显示:
C:\php\php.ini
说明配置文件已经被PHP加载。
如果显示没有加载配置文件,或者路径与你修改的文件不一致,就不要继续修改错误的文件。
这是Windows PHP配置中非常常见的一类问题。
十一、直接运行一个 PHP 程序
确认PHP版本和配置文件都正常以后,可以进行最简单的代码测试。
建立:
test.php
内容:
责任编辑:
MNewsTV 编辑部
转载请注明作者、出处並保持完整。
分享
Facebook
|
X
|
WhatsApp
|
LinkedIn
捐助(Paypal): https://www.paypal.me/observeccp
订阅中国观察电报 Telegram : https://t.me/s/ObserveCCP