在本地搭建Moodle在线教育平台时，XAMPP是很多开发者和教育工作者的首选环境，它集成了Apache、MySQL、PHP等Moodle运行所需的组件，能大幅降低部署难度。不过很多用户在配置XAMPP的数据库环节容易遇到问题，导致Moodle安装失败。
XAMPP环境准备
首先需要下载对应操作系统的XAMPP安装包，安装时建议选择默认路径，避免后续路径配置问题。安装完成后启动XAMPP控制面板，先启动Apache和MySQL两个服务，如果启动失败可以检查端口是否被占用，默认Apache使用80端口，MySQL使用3306端口，若被占用可以在XAMPP的配置文件里修改对应端口。
配置XAMPP数据库
Moodle安装需要独立的数据库和用户权限，不能直接使用XAMPP默认的root用户无密码连接，需要提前完成数据库配置。
创建Moodle专用数据库
打开浏览器访问http://localhost/phpmyadmin，进入phpMyAdmin管理界面，点击顶部导航栏的数据库选项，在数据库名称输入框填写moodle_db，排序规则选择utf8mb4_general_ci，点击创建按钮即可完成数据库创建。
创建数据库用户并授权
点击顶部导航栏的用户账户选项，再点击添加用户账户，按照以下参数填写：
- 用户名为
moodle_user - 主机名选择
本地，对应值为localhost - 密码设置复杂度足够的密码，比如
Moodle@2024 - 全局权限不要勾选，切换到
数据库选项卡，选择刚创建的moodle_db数据库，勾选所有权限
填写完成后点击执行，完成用户创建和授权。如果需要验证配置是否正确，可以用以下PHP代码测试数据库连接：
<?php
$servername = "localhost";
$username = "moodle_user";
$password = "Moodle@2024";
$dbname = "moodle_db";
// 创建连接
$conn = new mysqli($servername, $username, $password, $dbname);
// 检测连接
if ($conn->connect_error) {
die("数据库连接失败: " . $conn->connect_error);
}
echo "Moodle数据库连接成功";
$conn->close();
?>
部署Moodle并关联数据库
将下载的Moodle安装包解压，把解压后的所有文件复制到XAMPP的htdocs目录下，比如新建一个moodle文件夹存放，然后访问http://localhost/moodle进入Moodle安装向导。
安装过程中选择语言后，进入数据库设置页面，按照以下参数填写：
| 配置项 | 填写值 |
|---|---|
| 数据库类型 | mysqli |
| 数据库主机 | localhost |
| 数据库名称 | moodle_db |
| 数据库用户 | moodle_user |
| 数据库密码 | Moodle@2024 |
| 数据库端口 | 3306（如果修改过MySQL端口则填修改后的端口） |
填写完成后点击下一步，如果数据库配置正确，会进入Moodle的后续安装步骤，按照向导提示完成管理员账号设置、站点信息填写即可完成部署。
常见问题解决
如果Moodle安装时提示数据库连接失败，首先检查MySQL服务是否正常运行，然后核对数据库名称、用户名、密码是否和之前配置的一致。如果出现权限不足的问题，回到phpMyAdmin确认moodle_user对moodle_db数据库是否有全部操作权限。如果端口被占用导致Apache或MySQL启动失败，可以修改XAMPP安装目录下apache/conf/httpd.conf里的Listen 80为其他端口，修改mysql/bin/my.ini里的port=3306为其他端口即可。