Windows 下 PHP 开发环境搭建：从零到能跑项目的完整方案

目标关键词：Windows PHP 开发环境搭建

在 Windows 上搭建 PHP 开发环境，其实并不复杂。对新手来说，最关键的不是“装得多”，而是“装得对、配得稳、能快速运行项目”。如果只是做本地练习、学习 Laravel、WordPress、ThinkPHP，或者调试一个 PHP 网站，完全没必要一上来就搞得很复杂。本文就按“问题分析 → 解决方案 → 注意事项”的思路，把 Windows 下最常见、最实用的 PHP 环境搭建方法讲清楚，适合小白一步一步照着做。

一、先搞清楚：Windows 上搭 PHP 环境到底要装什么

一个能正常开发 PHP 项目的环境，通常离不开下面几样东西：

PHP 解释器
用来运行 .php 文件，是最核心的部分。
Web 服务器 例如 Apache、Nginx，负责让浏览器访问你的 PHP 网站。
数据库 常见的是 MySQL、MariaDB，用来存文章、用户、订单等数据。
扩展组件 比如 curl、gd、mbstring、pdo_mysql、openssl，这些是很多框架和程序必需的。
开发工具 例如 VS Code、PhpStorm，用来写代码、调试代码。

如果你只是想“装好就能用”，最省心的方法不是一个个手动装，而是直接用集成环境；如果你想了解原理，或者要做更灵活的配置，也可以选择手动安装。

二、推荐方案：新手优先用集成环境，最快最稳

如果你是第一次搭建 Windows PHP 开发环境，最推荐下面这几种方式：

方案一：XAMPP

适合人群：

新手
学习 PHP 基础
搭建 WordPress、ThinkPHP、Laravel 本地环境

优点：

安装简单
自带 Apache、MySQL、PHP、phpMyAdmin
启动关闭方便
网上教程多

缺点：

比较占资源
配置灵活性一般
某些高阶开发场景不如手动搭建

方案二：WampServer

适合人群：

只想在 Windows 上快速跑 PHP 程序
习惯图形化管理

优点：

界面简洁
切换 PHP 版本方便
对 Windows 兼容性不错

缺点：

生态和教程热度一般不如 XAMPP

方案三：Laragon

适合人群：

想要更现代、更轻便的 PHP 开发环境
开发 Laravel、WordPress、ThinkPHP 等项目

优点：

启动快
占用小
管理方便
支持一键创建站点
很适合日常开发

缺点：

对纯新手来说，初次接触可能不如 XAMPP 那么“傻瓜”

方案四：手动安装 PHP + Nginx/Apache + MySQL

适合人群：

有一定基础
想学习原理
需要更精细的配置

优点：

最灵活
最接近正式服务器环境
方便研究配置细节

缺点：

步骤多
容易踩坑
对新手不友好

结论：

小白首选：Laragon 或 XAMPP
想要开发体验更好：Laragon
想看教程最多：XAMPP
想深入学习：手动搭建

三、最推荐的新手搭建方法：Laragon 一键搭环境

如果你问“Windows 上 PHP 开发环境搭建，最省事的方法是什么”，我会优先推荐 Laragon。它很适合日常开发，尤其是做 Laravel、ThinkPHP、WordPress 这类项目。

1. 下载 Laragon

去 Laragon 官方页面下载 Windows 版本，注意选择稳定版。

建议安装到：

D:\Laragon
不建议装在 C:\Program Files，因为权限和路径容易出问题

2. 安装 Laragon

双击安装包，按默认步骤安装即可。

安装完成后，打开 Laragon，会看到主界面。

3. 启动服务

点击：

Start All

一般会自动启动：

Apache 或 Nginx
MySQL
PHP

如果服务正常，右下角状态会变成运行中。

4. 验证环境是否成功

打开浏览器输入：

http://localhost

如果看到 Laragon 欢迎页，说明环境已经跑起来了。

5. 创建第一个 PHP 项目

在 Laragon 里可以直接创建项目文件夹：

例如：

D:\Laragon\www\test

然后新建一个 index.php 文件，内容如下：

<?php
echo "Hello, PHP!";

浏览器访问：

http://test.test

如果能看到 Hello, PHP!，说明 PHP 环境正常。

四、如果你想更通用：XAMPP 搭建 PHP 环境步骤

XAMPP 是很多人学习 PHP 时最先接触的集成环境，优点是简单直观。

1. 安装 XAMPP

下载适合 Windows 的版本，安装时建议：

安装路径改成 D:\xampp
尽量不要装在中文路径
不要装在系统盘深层目录

2. 打开控制面板

安装完成后，打开 XAMPP Control Panel。

你会看到几个模块：

Apache
MySQL
FileZilla
Mercury
Tomcat

做 PHP 网站开发，通常只需要：

Apache
MySQL

点击 Start 启动 Apache 和 MySQL。

3. 检查端口是否冲突

如果 Apache 启动失败，常见原因是：

80 端口被 IIS 占用
443 端口被其他软件占用
Skype、VMware、某些安全软件冲突

解决办法：

先关闭占用端口的软件
或修改 Apache 的端口，比如改成 8080

浏览器访问：

http://localhost:8080

4. 放置网站文件

XAMPP 默认的网站目录一般是：

D:\xampp\htdocs

比如你新建一个项目文件夹：

D:\xampp\htdocs\myphp

再创建 index.php：

<?php
phpinfo();

浏览器访问：

http://localhost/myphp/

能正常显示 PHP 信息页面，就说明成功了。

五、手动搭建 PHP 环境：适合想深入学习的人

如果你不想依赖集成环境，下面是更接近真实服务器的搭建方式。这个方案更适合进阶用户。

1. 安装 PHP

先去官方下载对应 Windows 版本的 PHP。

注意选择：

Thread Safe（TS）：适合 Apache
Non Thread Safe（NTS）：适合 Nginx

如果你用的是 Apache，新手一般选 TS 版本。

下载后解压，比如放到：

D:\php

2. 配置 PHP 环境变量

打开：

“此电脑” → 右键 → 属性
高级系统设置
环境变量
在 Path 里添加：

D:\php

然后打开命令提示符，输入：

php -v

如果能显示版本号，说明 PHP 已经可用。

3. 配置 php.ini

PHP 解压后通常会有：

php.ini-development
php.ini-production

新手可以复制一个改名为：

php.ini

然后打开它，常见需要修改的项目包括：

开启常用扩展

找到这些行，去掉前面的分号：

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

设置时区

找到：

date.timezone =

改成：

date.timezone = Asia/Shanghai

修改上传限制

如果你要上传图片或导入数据，可以调大：

upload_max_filesize = 64M
post_max_size = 64M

4. 安装 Apache 或 Nginx

如果用 Apache

把 PHP 配进 Apache 配置文件中，通常需要增加：

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

如果用 Nginx

Nginx 需要通过 FastCGI 连接 PHP-FPM。Windows 下虽然也能配置，但不如 Linux 那么常见和稳定，新手不建议一开始就折腾这个。

5. 安装 MySQL

你可以安装：

MySQL Community Server
MariaDB

安装后设置：

root 密码
字符集 utf8mb4
允许本机访问

然后用命令行测试：

mysql -u root -p

六、推荐的开发工具搭配

环境装好以后，写代码的软件也很重要。

1. VS Code

适合：

新手
中轻度开发
学习 PHP、前端、数据库

推荐插件：

PHP Intelephense
PHP Debug
PHP Server
Chinese Language Pack

优点：

轻量
免费
插件丰富

2. PhpStorm

适合：

专业开发
大型项目
框架开发

优点：

提示更强
调试更完整
对 Laravel、Symfony 支持很好

缺点：

比较吃配置
付费软件

七、PHP 项目运行测试方法

环境装好后，建议先做几个简单测试。

测试 1：PHP 基础运行

创建 index.php：

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

浏览器打开后能显示文字，说明 PHP 没问题。

测试 2：查看 PHP 配置

创建：

<?php
phpinfo();

如果能看到详细配置页面，说明 PHP、Web 服务器连接正常。

测试 3：测试数据库连接

下面是一个简单的 MySQL 连接测试：

<?php
$host = '127.0.0.1';
$db   = 'test';
$user = 'root';
$pass = '你的密码';

$pdo = new PDO("mysql:host=$host;dbname=$db;charset=utf8mb4", $user, $pass);
echo "数据库连接成功";

如果输出“数据库连接成功”，说明 PHP 和 MySQL 已经联通。

八、常见问题排查

1. Apache 启动失败

常见原因：

80 端口被占用
443 端口被占用
安全软件拦截

解决办法：

关闭 IIS
修改 Apache 端口
以管理员身份运行
检查防火墙和杀毒软件

2. PHP 页面直接下载，而不是执行

这通常是：

Apache 没配置 PHP 模块
扩展没加载成功
服务器没识别 .php 文件

检查：

Apache 配置是否正确
PHP 路径是否写对
是否重启过服务

3. 数据库连不上

常见原因：

MySQL 没启动
密码错误
主机地址写错
数据库不存在

建议先确认：

MySQL 服务状态
用户名密码
数据库名是否正确

4. 中文乱码

通常是编码没统一。

建议：

数据库使用 utf8mb4
PHP 文件保存为 UTF-8
HTML 页面加上：

<meta charset="utf-8">

5. 扩展缺失

很多框架报错，核心原因就是扩展没开。

常见必备扩展：

pdo_mysql
mbstring
curl
openssl
gd
fileinfo
intl

九、Laravel、ThinkPHP、WordPress 的额外注意点

如果你搭环境不是单纯跑 phpinfo()，而是要装常见项目，还要注意下面几点。

Laravel

需要：

PHP 版本符合要求
openssl
mbstring
pdo_mysql
fileinfo
tokenizer

建议：

PHP 8.1 或 8.2 更稳
Composer 必装

安装 Composer 后，测试：

composer -V

ThinkPHP

需要：

PHP 版本匹配
pdo_mysql
mbstring
curl

如果访问报 404，注意伪静态规则是否正确。

WordPress

需要：

MySQL
PHP
mysqli
curl
openssl

如果后台上传图片失败，通常是：

上传目录权限问题
PHP 上传限制太小
GD 扩展没开

十、Composer 必装：现代 PHP 开发离不开它

如果你打算做框架开发，Composer 基本是必须的。

Composer 是什么

它是 PHP 的依赖管理工具，类似 Node.js 里的 npm。

安装方法

下载安装包，安装时它会自动检测 PHP 路径。

安装后命令行输入：

composer -V

如果能显示版本号，说明安装成功。

常用命令

创建项目：

composer create-project

安装依赖：

composer install

更新依赖：

composer update

十一、推荐配置：普通开发够用的环境组合

如果你不确定该怎么选，可以直接照这个配置走：

方案 A：最省心

Laragon
VS Code
Composer
MySQL
PHP 8.1 或 8.2

适合：

新手
学习
中小项目开发

方案 B：经典稳定

XAMPP
VS Code
Composer
MySQL

适合：

教程学习
本地测试
WordPress、ThinkPHP

方案 C：专业一些

手动 PHP
Nginx/Apache
MySQL/MariaDB
VS Code 或 PhpStorm
Composer
Git

适合：

进阶开发者
想贴近服务器环境
需要更细粒度配置

十二、环境搭建后的优化建议

1. 统一版本

尽量让：

PHP 版本
MySQL 版本
框架要求保持一致，减少兼容问题。

2. 关闭无用扩展

如果你不是做某些特殊功能，可以少开一些不必要扩展，减少干扰。

3. 项目和环境分盘放置

建议：

环境装在 D: 盘
项目文件单独管理
代码做好备份

4. 用 Git 管理代码

即使是本地学习，也建议习惯性使用 Git，防止误删和版本混乱。

5. 定期备份数据库

本地开发很容易改坏数据，建议定期导出 SQL。

十三、最适合新手的实际操作路线

如果你是完全没接触过 PHP 的小白，直接按下面顺序来：

第一步：安装 Laragon

最省事，少踩坑。

第二步：安装 VS Code

用于写代码。

第三步：安装 Composer

后面装框架必须用。

第四步：创建测试项目

写一个 index.php，确认能运行。

第五步：安装 MySQL 并创建数据库

测试 PHP 与数据库连接。

第六步：安装框架或 CMS

比如 Laravel、ThinkPHP、WordPress，开始实战。

十四、总结：Windows PHP 开发环境怎么选最合适

如果你只想快速上手，答案其实很简单：

新手首选 Laragon
教程多、资料多选 XAMPP
想深入理解就手动搭建
做现代 PHP 开发一定要配 Composer
写代码建议用 VS Code 或 PhpStorm

搭建 Windows PHP 开发环境的关键，不是追求“最复杂”，而是追求“最稳定、最适合自己、能持续开发”。先把环境跑通，再去研究细节，效率会高很多。只要按本文的步骤操作，大多数人都能顺利在 Windows 上搭出一套可用的 PHP 开发环境，用来学习、测试、开发项目都没有问题。

windows php 开发环境搭建

Windows 下 PHP 开发环境搭建：从零到能跑项目的完整方案

一、先搞清楚：Windows 上搭 PHP 环境到底要装什么

二、推荐方案：新手优先用集成环境，最快最稳

方案一：XAMPP

方案二：WampServer

方案三：Laragon

方案四：手动安装 PHP + Nginx/Apache + MySQL

三、最推荐的新手搭建方法：Laragon 一键搭环境

1. 下载 Laragon

2. 安装 Laragon

3. 启动服务

4. 验证环境是否成功

5. 创建第一个 PHP 项目

四、如果你想更通用：XAMPP 搭建 PHP 环境步骤

1. 安装 XAMPP

2. 打开控制面板

3. 检查端口是否冲突

4. 放置网站文件

五、手动搭建 PHP 环境：适合想深入学习的人

1. 安装 PHP

2. 配置 PHP 环境变量

3. 配置 php.ini

开启常用扩展

设置时区

修改上传限制

4. 安装 Apache 或 Nginx

如果用 Apache

如果用 Nginx

5. 安装 MySQL

六、推荐的开发工具搭配

1. VS Code

2. PhpStorm

七、PHP 项目运行测试方法

测试 1：PHP 基础运行

测试 2：查看 PHP 配置

测试 3：测试数据库连接

八、常见问题排查

1. Apache 启动失败

2. PHP 页面直接下载，而不是执行

3. 数据库连不上

4. 中文乱码

5. 扩展缺失

九、Laravel、ThinkPHP、WordPress 的额外注意点

Laravel

ThinkPHP

WordPress

十、Composer 必装：现代 PHP 开发离不开它

Composer 是什么

安装方法

常用命令

十一、推荐配置：普通开发够用的环境组合

方案 A：最省心

方案 B：经典稳定

方案 C：专业一些

十二、环境搭建后的优化建议

1. 统一版本

2. 关闭无用扩展

3. 项目和环境分盘放置

4. 用 Git 管理代码

5. 定期备份数据库

十三、最适合新手的实际操作路线

第一步：安装 Laragon

第二步：安装 VS Code

第三步：安装 Composer

第四步：创建测试项目

第五步：安装 MySQL 并创建数据库

第六步：安装框架或 CMS

十四、总结：Windows PHP 开发环境怎么选最合适

相关阅读

发表评论取消回复

还没有评论，来说两句吧...