Windows系统下安装与配置PHP 8详细步骤：从下载到环境搭建完整指南

来源：站长平台作者：陈平安头衔：全栈工程师

导读：本期聚焦于陈平安创作的《Windows系统下安装与配置PHP 8详细步骤：从下载到环境搭建完整指南》，敬请观看详情。想在Windows电脑上搭建PHP开发环境吗？这篇教程手把手教你从零开始安装PHP 8。我们会先告诉你从哪里下载正确的PHP版本，然后一步步讲解解压、配置环境变量、修改核心配置文件php.ini，最后验证安装是否成功。整个过程不需要复杂的工具，跟着步骤走就能搞定。不管你是刚入门的新手，还是想换新版本的老手，这份指南都能帮你避开常见的坑，顺利跑起PHP。

Windows系统安装PHP 8完整教程：从下载到配置一步到位

PHP 8作为一次重大更新，带来了JIT编译、命名参数、联合类型等众多新特性，性能相比之前版本有明显提升。对于在Windows上进行本地开发的程序员来说，正确安装和配置PHP 8是开展项目的基础。很多人在安装过程中会遇到各种小问题，比如环境变量不生效、扩展加载失败等。本文将从零开始，用最通俗的语言带你走完整个流程，确保每一步都清楚明白。

一、下载PHP 8安装包

选择合适的版本

首先要去PHP官方下载页面获取Windows版本的二进制包。官方下载地址是 windows.php.net/download，这里提供的是经过编译的现成版本，无需自己编译源码。进入页面后，你会看到多个PHP 8的子版本（例如8.0、8.1、8.2等），建议选择最新的稳定版本，因为新版本通常会修复已知漏洞并带来更好的性能。

理解两种构建版本的含义

在下载页面中，每个PHP版本都会提供两种类型的ZIP包：Non Thread Safe（非线程安全，简称NTS）和Thread Safe（线程安全，简称TS）。这两者的区别主要在于PHP的运行方式：

Thread Safe（TS）：线程安全版本。当你使用Apache服务器并以模块方式加载PHP时，需要选择这个版本。因为Apache是多进程/多线程模型，PHP模块需要在多线程环境下安全运行。对于大部分本地开发环境，如果你用的是Apache或者集成环境（如XAMPP、WampServer），通常推荐下载TS版本。
Non Thread Safe（NTS）：非线程安全版本。这种版本主要用于以FastCGI方式运行PHP的场景，比如IIS服务器或者使用PHP-FPM（虽然PHP-FPM在Windows上不太常见）。NTS版本去掉了线程安全相关的开销，理论上性能稍好，但前提是你的服务器软件能正确处理单线程请求。

如果你是初学者，不确定选哪个，可以这样判断：如果你打算用Apache做Web服务器，就下载TS版本；如果用IIS或者只是想用PHP内置的开发服务器做测试，NTS版本也够用。另外，现在很多开发者使用Nginx+PHP-FPM组合，但在Windows上PHP-FPM的支持并不完善，所以更常见的是用Apache或内置服务器。

下载ZIP压缩包

确定版本后，点击对应的ZIP链接下载。注意不要下载安装程序（Installer），因为安装程序有时会自动配置但不灵活，而且容易残留旧版本。ZIP包是绿色版，解压就能用，便于管理。

二、解压与目录配置

下载完成后，你会得到一个类似php-8.x.x-Win32-vs16-x64.zip的文件。接下来把它解压到一个合适的目录。

选择安装路径的建议

建议将PHP解压到一个没有中文、没有空格且路径简洁的文件夹，比如C:\php8。为什么不建议放在桌面或有中文的路径？因为后续配置环境变量和命令行使用时，中文或空格可能导致奇怪的编码问题或路径识别错误。另外，路径不要太深，比如C:\Program Files\PHP\8.0也是可以的，但要注意Program Files中间有空格，有些旧版工具处理不好，所以更推荐直接用C:\php8。

解压后的目录结构

解压后，你会看到以下重要文件和文件夹：

php.exe：PHP的命令行解释器，用于在命令行运行PHP脚本。
php-win.exe：不带控制台窗口的PHP解释器，通常用于后台运行。
php-cgi.exe：FastCGI模式的PHP解释器，用于IIS等服务器。
ext文件夹：存放PHP扩展的动态链接库（.dll文件），比如curl、mysqli、gd等。
php.ini-development：开发环境的配置文件模板，开启了较多调试选项。
php.ini-production：生产环境的配置文件模板，关闭了错误显示等，更安全。

三、配置环境变量

为了让系统在任何命令行路径下都能直接执行php命令，我们需要将PHP的安装目录添加到系统的PATH环境变量中。

为什么要配置环境变量

如果不配置环境变量，每次使用PHP都要切换到它的安装目录，或者在命令中写完整路径，非常麻烦。配置后，你可以在任何文件夹下打开命令提示符，直接输入php -v查看版本，或者运行php test.php执行脚本。

具体操作步骤

右键点击桌面上的“此电脑”或“我的电脑”，选择“属性”。
在打开的窗口左侧点击“高级系统设置”。
弹出“系统属性”对话框，点击底部的“环境变量”按钮。
在“环境变量”窗口中，下方是“系统变量”区域，找到名为Path的变量，选中它，然后点击“编辑”。
在编辑环境变量窗口中，点击右侧的“新建”，输入PHP的解压目录路径，比如C:\php8。注意不要加引号或末尾的反斜杠。
点击“确定”关闭所有窗口。

验证环境变量是否生效

配置完成后，需要重新打开一个命令提示符窗口（之前的窗口不会刷新环境变量）。输入php -v，如果看到类似 “PHP 8.x.x (cli)” 的输出，说明环境变量配置成功。如果提示“不是内部或外部命令”，请检查路径是否正确，并确保重新打开了命令行窗口。

四、配置PHP核心文件

PHP的行为由php.ini文件控制。默认情况下，PHP目录中没有这个文件，只有两个模板文件。我们需要手动创建并修改它。

创建php.ini文件

进入PHP安装目录（如C:\php8），找到php.ini-development文件。将其复制一份，然后重命名为php.ini。开发环境下使用php.ini-development作为基础，因为它开启了错误显示、警告等有助于调试的功能。而php.ini-production则关闭了这些，适合线上环境。

修改关键配置项

用记事本或其他文本编辑器打开php.ini，找到以下几个重要配置项进行修改：

设置扩展目录

搜索extension_dir，默认可能是被注释掉的（前面有分号）。将其修改为指向ext子目录的绝对路径。例如：

extension_dir = "C:\php8\ext"

注意路径中的反斜杠要写成双反斜杠或者正斜杠，否则可能被转义。推荐使用正斜杠，兼容性更好：

extension_dir = "C:/php8/ext"

启用常用扩展

继续往下翻，你会看到一系列;extension=开头的行。这些是PHP的扩展，前面的分号表示禁用。去掉分号就可以启用对应的扩展。对于Web开发，以下扩展几乎是必备的：

curl：用于发送HTTP请求，调用API。
gd：图像处理库，生成验证码、缩略图等。
mysqli：MySQL数据库的扩展接口。
pdo_mysql：PDO方式的MySQL驱动，更现代更安全。
mbstring：多字节字符串处理，支持中文等字符集。

将这些行的分号去掉，变成：

extension=curl
extension=gd
extension=mysqli
extension=pdo_mysql
extension=mbstring

注意：不同PHP版本中扩展名称可能略有不同，比如有的版本是php_curl.dll，但php.ini中只需要写extension=curl即可，系统会自动匹配。

其他常用配置

date.timezone：设置时区。搜索date.timezone，去掉注释并设置为Asia/Shanghai，这样时间函数返回的就是北京时间。
upload_max_filesize和post_max_size：如果需要上传大文件，可以适当增大这两个值，比如upload_max_filesize = 20M。
display_errors：开发环境下保持开启（On），方便调试；生产环境应关闭（Off）。

修改完成后保存文件。

五、验证安装是否成功

配置完成后，我们需要确认PHP能否正常运行，以及扩展是否加载成功。

检查PHP版本

打开新的命令提示符，输入：

php -v

如果输出类似下面的信息，说明PHP解释器工作正常：

PHP 8.2.12 (cli) (built: Oct 26 2023 14:44:41) ( ZTS Visual C++ 2019 )
Copyright (c) The PHP Group
Zend Engine v4.2.12, Copyright (c) Zend Technologies

注意其中的“ZTS”表示线程安全版本，“NTS”则表示非线程安全。

检查扩展是否加载

输入命令php -m，可以列出所有已加载的模块。你应该能看到刚才启用的 curl、gd、mysqli、pdo_mysql、mbstring 等出现在列表中。如果没有出现某个扩展，说明配置有问题，需要检查php.ini中的 extension_dir 是否正确，以及对应的 .dll 文件是否存在于 ext 目录中。

创建测试文件

为了进一步验证，可以编写一个简单的PHP脚本来输出PHP信息。在任意目录（比如C:\test）新建一个info.php文件，内容如下：

<?php
phpinfo();

然后在命令行中切换到该目录，执行：

php info.php

如果一切正常，屏幕上会输出大量的PHP配置信息，包括版本、扩展、环境变量等。注意，phpinfo()函数会输出HTML格式的内容，在命令行中显示会比较杂乱，但这属于正常现象。如果你想看到更整洁的输出，可以用php -r "phpinfo();"或者将输出重定向到文件后用浏览器查看。

六、常见问题与解决方法

即使按照步骤操作，新手也可能遇到一些问题。下面列出最常见的几种情况及其解决办法。

问题1：“php不是内部或外部命令”

原因：环境变量配置错误或未生效。

解决：重新检查Path变量中是否添加了正确的PHP目录（如C:\php8）。注意不要有多余的空格或分号。修改后一定要关闭并重新打开命令行窗口。如果仍然不行，重启电脑试试。

问题2：缺少VCRUNTIME140.dll或MSVCP140.dll

原因：PHP 8依赖Visual C++ Redistributable运行库。Windows系统可能没有预装最新版本。

解决：前往微软官网下载并安装“Visual Studio 2015-2022 Redistributable”（x64版本）。安装后重启命令行即可。注意，PHP 8通常需要VS16（Visual Studio 2019）或更高版本的运行库，所以尽量安装最新的合集包。

问题3：扩展无法加载，提示找不到指定模块

原因：extension_dir路径不正确，或者扩展文件本身缺失。

解决：打开php.ini，确认extension_dir的值是绝对路径并且指向了ext子目录。例如C:/php8/ext。同时检查ext文件夹里是否存在对应的.dll文件，比如php_curl.dll。如果文件不存在，说明下载的PHP包可能不完整，需要重新下载。

问题4：php -v 显示版本但 php -m 看不到某些扩展

原因：扩展虽然在php.ini中启用了，但可能依赖其他库或配置。

解决：检查扩展之间的依赖关系。例如，gd扩展可能需要libpng、libjpeg等，但这些通常已经静态编译进PHP了。如果依然不行，可以尝试在命令行中运行php -i | findstr "extension_dir"查看实际的扩展目录是否和你设置的一致。另外，注意不要重复加载同一个扩展。

问题5：运行PHP脚本时出现空白页或报错

原因：脚本本身有语法错误，或者PHP配置中禁用了错误显示。

解决：在php.ini中确保display_errors = On和error_reporting = E_ALL。然后重新运行脚本，一般会看到具体的错误信息。如果依然空白，可以尝试用命令行运行php -l 文件名.php进行语法检查。

七、进阶：配置Web服务器与PHP协同工作

如果你的目标是搭建完整的本地开发环境，还需要将PHP与Web服务器（如Apache或Nginx）整合。这里简单提一下思路：

使用Apache

下载Apache的Windows版本（比如Apache Lounge提供的二进制包），解压后修改conf/httpd.conf，添加加载PHP模块的指令：

LoadModule php_module "C:/php8/php8apache2_4.dll"
AddType application/x-httpd-php .php
PHPIniDir "C:/php8"

注意：这里的php8apache2_4.dll文件位于PHP安装目录下，是Apache专用的模块文件。只有TS版本的PHP才包含这个文件。

使用PHP内置服务器

对于简单测试，不需要安装Apache，可以直接使用PHP自带的内置Web服务器。在项目目录下运行：

php -S localhost:8000

然后浏览器访问http://localhost:8000即可。这种方式适合快速原型开发，但不适合生产环境。

至此，你已经完成了Windows系统下PHP 8的完整安装与配置。整个过程虽然步骤不少，但只要耐心按照指南操作，基本不会遇到太大障碍。如果在配置过程中遇到其他问题，欢迎查阅PHP官方文档或在开发者社区搜索解决方案。祝你开发愉快！

PHP 8安装 Windows PHP 环境变量配置 php.ini 扩展配置修改时间：2026-08-12 00:50:44

免责声明：已尽一切努力确保本网站所含信息的准确性。网站内容多为原创整理与精心编撰，观点力求客观中立。本站旨在免费分享，内容仅供个人学习、研究或参考使用。若引用了第三方作品，版权归原作者所有。如内容涉及您的权益，请联系我们处理。