Moodle-Docker环境部署：从0到1的避坑手册

【免费下载链接】moodle-docker A docker environment for moodle developers 项目地址: https://gitcode.com/gh_mirrors/mo/moodle-docker

一、项目核心价值：为什么选择Moodle-Docker？

作为Moodle开发者或测试人员，你是否曾因环境配置复杂而浪费数小时？是否遇到过"在我电脑上能运行"的经典困境？Moodle-Docker通过容器化技术，将复杂的Moodle运行环境打包成标准化配置，支持PostgreSQL、MySQL等多数据库类型，集成Behat/Selenium自动化测试工具，还能通过Mailpit捕获SMTP消息。这个开源项目最大的价值在于：让开发者专注于功能开发，而非环境调试。

二、三大技术壁垒突破指南

2.1 环境适配检测：为什么版本不匹配会导致服务启动失败？

问题现象：运行docker-compose up时出现"version mismatch"错误，或容器启动后立即退出。
根本原因：Docker引擎与Docker Compose版本未满足项目最低要求。

实施步骤：

1. 执行版本检测命令：

   docker --version  # 需≥20.10.15
   docker-compose --version  # 需≥2.5.0
   

2. 若版本过低，执行升级命令（以Ubuntu为例）：

   # 卸载旧版本
   sudo apt-get remove docker docker-engine docker.io containerd runc
   # 安装最新版
   curl -fsSL https://get.docker.com -o get-docker.sh
   sudo sh get-docker.sh
   

3. ✅ 验证通过：命令输出版本号满足要求

避坑指南：

• 使用docker-compose version而非docker compose version（注意空格），部分系统两者共存
• 版本冲突时执行docker-compose down -v清理残留 volumes 后重试

2.2 动态参数调优：环境变量如何影响容器行为？

问题现象：访问Moodle页面显示数据库连接错误，或容器日志出现"MOODLE_DOCKER_WWWROOT not set"提示。
根本原因：核心环境变量未正确配置，导致容器间无法正确通信。

实施步骤：

1. 创建环境变量配置文件.env：

   # 设置Moodle代码路径
   export MOODLE_DOCKER_WWWROOT=/path/to/your/moodle/code
   # 设置数据库类型（可选值：pgsql/mysql/mssql/oracle）
   export MOODLE_DOCKER_DB=pgsql
   # 保存到环境变量
   echo "export MOODLE_DOCKER_WWWROOT=$MOODLE_DOCKER_WWWROOT" >> ~/.bashrc
   source ~/.bashrc
   

2. ✅ 验证通过：执行echo $MOODLE_DOCKER_WWWROOT显示正确路径

避坑指南：

• 创建批量导入脚本env-setup.sh：

  #!/bin/bash
  export MOODLE_DOCKER_WWWROOT=/path/to/moodle
  export MOODLE_DOCKER_DB=pgsql
  export MOODLE_DOCKER_PHP_VERSION=8.1
  

• 执行chmod +x env-setup.sh && source ./env-setup.sh快速加载环境变量

2.3 代码获取策略：如何正确克隆Moodle源代码？

问题现象：克隆代码时出现"repository not found"，或启动后页面显示文件缺失。
根本原因：Git命令使用不当或仓库地址错误。

实施步骤：

1. 确认Git已安装：

   git --version  # 输出类似 "git version 2.34.1"
   

2. 克隆指定分支的Moodle代码：

   # 克隆稳定版分支（以4.03为例）
   git clone -b MOODLE_403_STABLE https://gitcode.com/gh_mirrors/mo/moodle-docker $MOODLE_DOCKER_WWWROOT
   

3. ✅ 验证通过：目标目录下出现config.php等核心文件

避坑指南：

• 网络问题时添加代理：git config --global http.proxy http://proxy:port
• 分支选择参考Moodle官方支持周期，避免使用EOL（已结束支持）版本

三、进阶技巧：从能用 to 好用

3.1 多环境切换方案

创建环境切换脚本switch-env.sh：

#!/bin/bash
# 切换到MySQL环境
export MOODLE_DOCKER_DB=mysql
docker-compose -f base.yml -f db.mysql.yml up -d

3.2 测试自动化集成

利用项目内置测试脚本：

# 运行PHPUnit测试
./tests/phpunit-test.sh
# 运行Behat测试
./tests/behat-test.sh

通过以上指南，你已掌握Moodle-Docker的核心部署技巧。记住：容器化环境的精髓在于"一次配置，到处运行"，保持环境一致性是提高开发效率的关键。当遇到问题时，优先检查版本兼容性和环境变量配置，这两个环节解决了80%的常见问题。

【免费下载链接】moodle-docker A docker environment for moodle developers 项目地址: https://gitcode.com/gh_mirrors/mo/moodle-docker