Windows 安装 PHP 环境：从零搭建到可用的完整教程

关键词

Windows 安装 PHP 环境

如果你想在 Windows 上跑 PHP，本质上有三种常见方式：

1. 纯手动安装 PHP
2. 安装集成环境包，比如 XAMPP、WampServer、phpStudy
3. 用 Docker / 虚拟机部署 PHP 环境

如果你是新手，最推荐的是 集成环境包；如果你是开发者、想要更灵活控制版本和配置，建议直接 手动安装 PHP。下面这篇文章会把这两种方法都讲清楚，适合从小白一路用到进阶用户。

---

一、Windows 为什么要安装 PHP 环境

PHP 是一种常见的 Web 开发语言，很多网站、后台系统、CMS 程序都会用到它，比如 WordPress、ThinkPHP、Drupal 等。

在 Windows 里安装 PHP 环境，主要有这些用途：

• 本地调试网站程序
• 学习 PHP 语法和项目开发
• 测试 WordPress、Discuz、Laravel 等程序
• 配合 MySQL、Apache 或 Nginx 搭建网站环境
• 做接口测试、后端开发、程序部署

如果只是简单学习或测试，Windows 完全够用，不一定非要上 Linux 服务器。

---

二、先搞清楚 PHP 环境需要哪些组件

一个能正常运行 PHP 网站的环境，通常包含下面几部分：

• PHP：核心解释器
• Web 服务器：Apache 或 Nginx
• 数据库：MySQL、MariaDB 或 SQLite
• 扩展组件：如 openssl、mysqli、curl、gd、mbstring 等
• 运行工具：浏览器、文本编辑器、命令行工具

如果你只是想让 PHP 跑起来，最少只需要：

• PHP 本体
• 命令行环境
• 一个测试文件

如果你要跑网站项目，通常还要配上：

• Apache / Nginx
• MySQL
• phpMyAdmin 或数据库管理工具

---

三、新手最推荐的方式：安装集成环境

如果你是电脑小白，最省事的办法就是装集成环境。它会帮你把 PHP、Apache、MySQL 等常用组件一次性打包好，安装完基本就能用。

1. 常见集成环境

下面这些都比较常见：

• XAMPP：跨平台，国外用户多，稳定性不错
• WampServer：偏 Windows 用户，操作相对直观
• phpStudy：国内用户用得多，上手快
• Laragon：对开发者很友好，轻量、切换版本方便

2. 适合谁

• 小白用户：phpStudy、XAMPP
• 开发者：Laragon
• 传统网站环境：WampServer

3. 集成环境安装步骤

以 XAMPP 或 phpStudy 为例，步骤基本一致：

第一步：下载软件

去官网下载安装包，尽量选稳定版，不要随便下第三方修改版。

第二步：双击安装

安装时建议注意这几点：

• 安装路径尽量别放在 C:\Program Files 里
• 建议放到类似 D:\phpEnv\ 这种简单路径
• 路径里不要有中文和空格，减少兼容问题

第三步：启动服务

安装完成后，打开控制面板，启动：

• Apache
• MySQL

如果你只是测试 PHP，Apache 不开也不行，因为 PHP 通常要通过 Web 服务器运行。

第四步：放测试文件

在网站根目录下新建一个 index.php 文件，内容如下：

<?php
phpinfo();

然后在浏览器访问：

https://www.liubo.wang/

如果页面能正常显示 PHP 信息，说明环境已经成功。

---

四、进阶推荐：手动安装 PHP 环境

如果你想更清楚地知道每个组件是怎么工作的，建议手动安装。这样以后遇到报错，也更容易排查。

---

五、Windows 手动安装 PHP 环境的完整步骤

1. 下载 PHP

先去 PHP 官方网站下载 Windows 版本。

下载时要注意：

• 选 Thread Safe（线程安全版）
• 一般搭配 Apache 用线程安全版更合适
• 如果只是命令行使用，也可以考虑 Non Thread Safe

版本建议

• 学习和兼容性优先：PHP 8.1 / 8.2
• 老项目兼容：PHP 7.4
• 新项目开发：优先最新版稳定版

如果你是新手，建议直接装 PHP 8.2 左右的稳定版本，兼容性和性能都比较平衡。

---

2. 解压到指定目录

建议解压到：

D:\php

或者：

C:\php

不要放到路径很深的目录，也不要放中文路径。

---

3. 配置 php.ini

PHP 解压后，默认可能没有 php.ini 文件，这时你可以：

• 找到 php.ini-development
• 复制一份，改名为 php.ini

然后打开它，修改几个关键参数。

常用配置项

设置扩展目录

找到：

;extension_dir = "ext"

改成：

extension_dir = "ext"

或者写绝对路径：

extension_dir = "D:\php\ext"

开启常用扩展

把这些前面的分号去掉：

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

这些扩展对大多数网站程序都很重要。

设置时区

找到：

;date.timezone =

改成：

date.timezone = Asia/Shanghai

这样可以避免很多时间相关报错。

调整上传限制

如果你要做网站上传测试，可以顺手改一下：

upload_max_filesize=20M
post_max_size=20M
memory_limit=256M

---

4. 配置系统环境变量

为了能在命令行里直接输入 php，你要把 PHP 加到系统环境变量。

操作步骤

1. 右键“此电脑”
2. 点击“属性”
3. 进入“高级系统设置”
4. 点击“环境变量”
5. 找到系统变量里的 Path
6. 点击“编辑”
7. 新增 PHP 路径，例如：

D:\php

8. 确认保存

测试是否成功

打开 CMD，输入：

php -v

如果显示 PHP 版本号，说明配置正确。

---

5. 配置 Apache 让 PHP 能运行

如果你装了 Apache，需要让它知道怎么调用 PHP。

假设你的 PHP 安装目录是：

D:\php

Apache 的配置文件一般在：

D:\Apache24\conf\httpd.conf

在配置文件里加入类似下面的内容：

LoadModule php_module D:/php/php8apache2_4.dll
PHPIniDir "D:/php"
AddHandler application/x-httpd-php .php
DirectoryIndex index.php index.html

注意

• 这里的 DLL 文件名要和你的 PHP 版本对应
• Apache 版本和 PHP 版本必须匹配
• 路径要用正斜杠 / 或双反斜杠 \\

如果 Apache 启动报错，通常是版本不匹配或者 DLL 路径写错了。

---

六、测试 PHP 环境是否成功

1. 命令行测试

打开 CMD，执行：

php -v

如果显示版本信息，说明 PHP 命令可用。

再执行：

php -m

可以查看已加载模块。

---

2. 浏览器测试

在网站根目录建一个 test.php 文件，内容如下：

<?php
echo "PHP环境正常";

然后访问：

https://www.liubo.wang/test.php

如果能看到“PHP环境正常”，说明 Web 环境没问题。

---

3. phpinfo 测试

再建一个：

<?php
phpinfo();

打开后会显示详细的 PHP 配置页面，可以查看：

• PHP 版本
• 已启用扩展
• 配置文件路径
• 上传限制
• 时区设置

这是判断环境是否完整最直观的方法。

---

七、Windows 安装 PHP 环境常见问题

1. php 不是内部或外部命令

原因

PHP 没加到环境变量里，或者加错路径了。

解决方法

• 检查 Path
• 确认加的是 PHP 安装目录
• 重新打开 CMD 再试

---

2. Apache 启动失败

常见原因

• 80 端口被占用
• PHP 模块路径错误
• 版本不兼容

解决方法

查看端口占用：

netstat -ano | findstr :80

如果被占用，可以：

• 关闭占用软件
• 修改 Apache 监听端口，比如改成 8080

---

3. 浏览器打开 PHP 文件显示源码

原因

PHP 没有交给 Web 服务器解析，可能是 Apache 没配置好。

解决方法

• 确认通过 https://www.liubo.wang/ 访问
• 不要直接双击 .php 文件打开
• 检查 Apache 是否加载了 PHP 模块

---

4. PHP 扩展未加载

原因

php.ini 没改对，或者扩展目录不对。

解决方法

• 确认 extension_dir 正确
• 去掉扩展名前的分号
• 重启 Apache / 重新打开命令行

---

5. 中文乱码

原因

编码设置不一致。

解决方法

• 编辑器保存为 UTF-8
• 页面输出时加上：

header("Content-Type:text/html; charset=utf-8");

• Apache 站点配置中统一字符集

---

八、推荐的 Windows PHP 环境搭配方案

方案一：最省事的方案

适合：新手、小白、临时测试

• phpStudy
• PHP 8.2
• MySQL 8.0
• Apache

优点：

• 安装快
• 上手简单
• 配置少

缺点：

• 深度学习价值不如手动搭建

---

方案二：开发者常用方案

适合：程序员、长期开发

• PHP 手动安装
• Apache 或 Nginx
• MySQL
• VS Code
• Composer

优点：

• 可控性强
• 方便切换版本
• 更接近生产环境

缺点：

• 配置更复杂

---

方案三：现代开发方案

适合：中高级开发者

• Windows + WSL2 + Ubuntu
• PHP + Nginx + MySQL
• Docker 容器化部署

优点：

• 更接近服务器环境
• 适合部署和协作
• 可复用性强

缺点：

• 对小白不够友好

---

九、安装 PHP 后建议顺手装的工具

1. Composer

PHP 的依赖管理工具，做现代 PHP 开发几乎离不开它。

常见用途：

• 安装框架
• 管理第三方库
• 统一项目依赖

安装后测试：

composer -V

---

2. VS Code

轻量、免费、插件丰富，适合写 PHP。

建议装这些插件：

• PHP Intelephense
• PHP Debug
• Prettier
• Chinese Language Pack

---

3. 数据库管理工具

例如：

• DBeaver
• Navicat
• phpMyAdmin

新手推荐 DBeaver，免费且通用。

---

十、安装时的实用避坑建议

1. 不要乱装多个 PHP 版本

多个版本共存时，命令行和网站服务很容易调用错版本。
建议：

• 学习阶段保留一个主版本
• 必要时再用不同目录切换

---

2. 安装路径尽量简单

推荐：

D:\php
D:\web
D:\mysql

不要用：

D:\我的工具\PHP环境\最新版\

路径越复杂，出错概率越高。

---

3. 64 位系统优先装 64 位版本

现在大多数电脑都是 64 位系统，PHP、Apache、MySQL 也尽量保持一致，减少兼容问题。

---

4. 注意 VC 运行库

有些 PHP 版本需要 Microsoft Visual C++ 运行库支持。
如果 PHP 启动异常，先检查系统有没有装对应运行库。

---

5. 重启服务很重要

改完 php.ini、Apache 配置、环境变量之后，不重启服务或终端，很多修改不会生效。

---

十一、不同用户的安装建议

新手用户

直接用：

• phpStudy 或 XAMPP

理由：

• 不用自己处理太多配置
• 出问题也容易排查
• 适合入门学习

进阶用户

建议：

• 手动安装 PHP
• 配 Apache 或 Nginx
• 再加 MySQL 和 Composer

理由：

• 能学到真实环境配置
• 方便以后上线部署

专业开发用户

建议：

• Windows + WSL2
• Docker 容器化
• Nginx + PHP-FPM + MySQL

理由：

• 更适合团队协作
• 更接近生产环境
• 部署更标准化

---

十二、总结：Windows 安装 PHP 环境怎么选

如果你只想快速用起来：

• 直接装 phpStudy / XAMPP

如果你想认真学 PHP：

• 手动安装 PHP + Apache + MySQL + Composer

如果你要做正式开发：

• 推荐 Docker 或 WSL2 + Linux 环境

总体来说，Windows 上安装 PHP 环境并不难，关键是要搞清楚三个点：

1. PHP 本体是否正常
2. Web 服务器是否正确调用 PHP
3. 环境变量和扩展是否配置完整

只要按步骤来，先测试 php -v，再测试 phpinfo()，再访问本地页面，基本就能把环境搭起来。