教程概览
对于初学者,我强烈推荐使用集成环境包,因为它简单快捷,能让你快速开始开发,对于有经验的开发者或需要高度定制环境的用户,手动安装则提供了更大的灵活性。

(图片来源网络,侵删)
-
集成环境包 (推荐新手)
- 优点:一键安装,配置简单,包含 Apache/Nginx、PHP、MySQL 等所有必需组件,版本兼容性好。
- 缺点:灵活性较低,环境更新可能滞后。
- 推荐工具:
XAMPP(跨平台,最流行),WampServer(仅限 Windows),MAMP(仅限 macOS)。
-
手动安装 (推荐进阶)
- 优点:完全控制每个组件的版本和配置,环境纯净,更接近生产服务器。
- 缺点:步骤繁琐,需要手动解决各种依赖和配置问题。
- 组件:分别安装
Apache/Nginx、PHP、MySQL。
使用 XAMPP 集成环境包 (Windows/macOS/Linux)
XAMPP 是最流行、最容易上手的集成环境解决方案。
步骤 1:下载 XAMPP
- 访问 XAMPP 官方网站:https://www.apachefriends.org/
- 根据你的操作系统(Windows, macOS, Linux)下载对应的版本。
- 注意:对于 Windows,推荐下载
XAMPP for Windows,对于 macOS,下载XAMPP for macOS。
- 注意:对于 Windows,推荐下载
- 选择一个包含你所需 PHP 版本的包,最新版本通常包含较新的 PHP。
步骤 2:安装 XAMPP
- 找到你下载的安装包(
xampp-windows-x64-8.2.0-0-VS16-installer.exe)。 - 双击运行安装程序。
- 按照安装向导的提示进行操作。大部分选项都可以使用默认设置。
- 在选择组件的界面,确保
Apache(Web 服务器)、MySQL(数据库服务器) 和PHP被勾选。 - 你可以选择安装路径,但默认的
C:\xampp(Windows) 或/Applications/XAMPP(macOS) 通常是最好的选择。
- 在选择组件的界面,确保
- 等待安装完成。
步骤 3:启动并测试服务
- 安装完成后,启动 XAMPP Control Panel。
- 你会看到 Apache 和 MySQL 的模块,点击每个模块右侧的
Start按钮。- Apache:启动你的本地 Web 服务器。
- MySQL:启动你的本地数据库服务器。
- ProFTPD:一个 FTP 服务器,通常不需要启动。
- 看到
Apache和MySQL模块的Status变为Running,并且按钮变为Stop,说明服务已成功启动。 - 打开你的浏览器,访问
http://localhost或http://127.0.0.1。 - 如果看到 XAMPP 的欢迎页面,恭喜你,Web 服务器已成功运行!
步骤 4:配置虚拟主机 (可选,但推荐)
直接使用 http://localhost 访问项目不够灵活,配置虚拟主机可以为每个项目设置一个独立的域名(如 http://myproject.local)。

(图片来源网络,侵删)
以 Windows 为例:
-
编辑
hosts文件:- 按
Win + R,输入drivers/etc/hosts并回车,用记事本打开该文件。 - 在文件末尾添加一行:
0.0.1 myproject.local,这样系统就会把myproject.local解析到你的本地电脑。
- 按
-
编辑 Apache 配置文件:
- 在 XAMPP 安装目录下,找到
apache/conf/extra/httpd-vhosts.conf文件,用文本编辑器打开。 - 在文件末尾,复制并修改下面的模板:
<VirtualHost *:80> DocumentRoot "C:/xampp/htdocs/myproject" # 你的项目根目录 ServerName myproject.local # 你在 hosts 文件中设置的域名 <Directory "C:/xampp/htdocs/myproject"> Options Indexes FollowSymLinks AllowOverride All Require all granted </Directory> </VirtualHost>- 将
DocumentRoot和ServerName修改为你自己的信息。
- 在 XAMPP 安装目录下,找到
-
启用
mod_rewrite模块:
(图片来源网络,侵删)- 很多 PHP 框架(如 Laravel)需要这个模块来实现 URL 重写。
- 打开
apache/conf/httpd.conf文件。 - 找到
#LoadModule rewrite_module modules/mod_rewrite.so这一行,删除前面的 号。 - 保存
httpd.conf和httpd-vhosts.conf文件。
-
重启 Apache:
- 回到 XAMPP Control Panel,点击 Apache 的
Stop按钮,等它完全停止后,再点击Start。
- 回到 XAMPP Control Panel,点击 Apache 的
-
测试:
- 将你的项目文件放到你指定的目录(如
C:/xampp/htdocs/myproject)。 - 在浏览器中访问
http://myproject.local,你应该能看到你的项目了。
- 将你的项目文件放到你指定的目录(如
步骤 5:使用 phpMyAdmin 管理数据库
phpMyAdmin 是一个用 PHP 编写的、通过 Web 界面管理 MySQL 的工具,XAMPP 已经自带了。
- 确保 MySQL 服务正在运行。
- 在浏览器中访问
http://localhost/phpmyadmin。 - 默认情况下,root 用户没有密码,直接点击 “执行” 或 “Go” 即可登录。
- 登录后,你可以在这里创建数据库、用户,以及执行所有数据库管理操作。
手动安装 (以 Windows 为例)
这种方法更复杂,但能让你更好地理解每个组件的作用。
组件准备
- PHP: 从 PHP 官网 下载最新的 Windows ZIP 包(Thread Safe 版本,搭配 Apache 使用)。
- Apache: 从 Apache Lounge 官网 下载最新的 Apache 版本(选择
httpd-...-win64-VCxx.zip)。 - MySQL: 从 MySQL 官网 下载 MySQL Installer for Windows。
安装步骤
-
安装 MySQL
- 运行你下载的 MySQL Installer。
- 选择 "Full"(完整安装)或 "Custom"(自定义安装),新手建议选择 "Full"。
- 按照向导操作,在设置 root 密码的步骤,务必设置一个强密码并记住它。
-
安装 Apache
- 将下载的 Apache ZIP 包解压到一个固定路径,
C:\Apache24。路径中不要包含空格和中文。 - 打开命令提示符(CMD),以管理员身份运行。
- 进入 Apache 的
bin目录:cd C:\Apache24\bin - 执行安装命令:
httpd -k install - 如果提示你输入服务器名称,可以输入
localhost。 - 启动 Apache 服务:
httpd -k start - 在浏览器访问
http://localhost,如果看到 "It works!",说明 Apache 安装成功。
- 将下载的 Apache ZIP 包解压到一个固定路径,
-
安装 PHP
-
将下载的 PHP ZIP 包解压到一个固定路径,
C:\php。 -
将
C:\php目录下的php.ini-development文件复制一份,重命名为php.ini,这是 PHP 的主配置文件。 -
配置
php.ini:- 用记事本打开
C:\php\php.ini。 - 搜索并取消以下配置项的注释(删除前面的分号 ):
extension_dir = "ext"->extension_dir = "C:\php\ext"(填写你的绝对路径)- 根据你的需要,启用常用扩展,
;extension=mysqli->extension=mysqli(用于连接 MySQL);extension=curl->extension=curl(用于 HTTP 请求);extension=gd->extension=gd(用于图像处理);extension=mbstring->extension=mbstring(用于多字节字符串处理)
- 用记事本打开
-
让 Apache 加载 PHP:
-
打开 Apache 的配置文件
C:\Apache24\conf\httpd.conf。 -
在文件末尾添加以下两行代码:
# 加载 PHP 模块 LoadModule php_module "C:/php/php8apache2_4.dll" # 注意:文件名可能因 PHP 版本而异,请根据你的文件名修改 # 将 .php 文件交给 PHP 模块处理 AddHandler application/x-httpd-php .php
-
确保
LoadModule指令指向了正确的 PHP 模块 DLL 文件。
-
-
-
整合与测试
- 重启 Apache 服务:在 CMD 中执行
httpd -k restart。 - 在 Apache 的网站根目录(默认是
C:\Apache24\htdocs)下创建一个名为info.php的文件,内容如下:<?php phpinfo(); ?>
- 在浏览器中访问
http://localhost/info.php。 - 如果看到一个详细的 PHP 配置信息页面,说明 PHP 和 Apache 已经成功整合!检查页面中是否有
MySQL相关的信息,以确认mysqli扩展已成功加载。
- 重启 Apache 服务:在 CMD 中执行
手动安装 phpMyAdmin
- 从 phpMyAdmin 官网 下载最新版本。
- 将下载的 ZIP 包解压到 Apache 的网站根目录
C:\Apache24\htdocs下,并重命名文件夹为phpmyadmin。 - 进入
phpmyadmin目录,找到config.sample.inc.php文件,复制一份并重命名为config.inc.php。 - 打开
config.inc.php,找到$cfg['blowfish_secret'] = '';这一行,在引号内填入一个任意的随机字符串,$cfg['blowfish_secret'] = 'b1s2c3r4e5t6'; // 任意字符串
- 保存文件,现在你就可以通过
http://localhost/phpmyadmin访问 phpMyAdmin 了,使用你之前设置的 MySQL root 用户名和密码登录。
总结与常见问题
| 方法 | 优点 | 缺点 | 适合人群 |
|---|---|---|---|
| 集成环境 | 快速、简单、一键启动、组件齐全 | 不够灵活、环境固定 | 初学者、快速开发测试 |
| 手动安装 | 灵活可控、环境纯净、贴近生产 | 复杂、耗时、易出错 | 有经验的开发者、需要定制环境的用户 |
常见问题 (FAQ)
-
Q: 端口 80 被占用怎么办?
- 原因:可能是 Skype、IIS、其他 Web 服务器等程序占用了 80 端口。
- 解决:关闭占用端口的程序,或在 Apache/MySQL 配置中修改端口号(如 Apache 改为 8080)。
-
Q: 如何修改网站根目录?
- XAMPP: 修改
apache/conf/httpd.conf文件中的DocumentRoot "C:/xampp/htdocs"和<Directory "C:/xampp/htdocs">指令。 - 手动安装: 修改
Apache24/conf/httpd.conf文件中的DocumentRoot指令。
- XAMPP: 修改
-
Q: 如何从命令行启动/停止服务?
- XAMPP: 使用 XAMPP Control Panel。
- 手动安装: 打开 CMD (管理员),进入对应组件的
bin目录,使用httpd -k start/stop/restart和net start/stop mysql命令。
-
Q: 在代码中如何连接 MySQL?
-
使用
mysqli或PDO扩展,一个简单的mysqli连接示例:<?php $servername = "localhost"; $username = "root"; $password = "你的密码"; // 如果是 XAMPP,默认为空;手动安装为你设置的 root 密码 $dbname = "test_db"; // 创建连接 $conn = new mysqli($servername, $username, $password, $dbname); // 检查连接 if ($conn->connect_error) { die("连接失败: " . $conn->connect_error); } echo "连接成功"; $conn->close(); ?>
-
希望这份详细的教程能帮助你成功搭建 PHP + MySQL 开发环境!祝你编码愉快!
