本地Docker部署Moodle 4.1测试时阻止批量邮件发送的方法

一、先修复config.php未挂载生效的问题 #

容器内使用镜像自带config.php而非生产环境版本，大概率是挂载配置有误或镜像启动逻辑覆盖了文件：

• 检查挂载路径匹配度：确认docker-compose.yml中moodle服务的volumes配置是否指向镜像的Moodle根目录。以官方Moodle镜像为例，其Web根目录为/var/www/html，正确挂载配置应为：

  volumes:
    - ./your-local-moodle-folder:/var/www/html
    - ./your-local-moodledata:/var/www/moodledata
  

  若挂载路径错误，生产环境的config.php无法覆盖镜像文件，需修正路径。
• 直接挂载单独的config.php文件：若挂载整个moodle目录仍被镜像初始化脚本覆盖，可单独挂载生产环境的config.php：

  volumes:
    - ./your-production-config.php:/var/www/html/config.php
    - ./your-local-moodle-folder:/var/www/html
    - ./your-local-moodledata:/var/www/moodledata
  

  单独挂载的文件优先级高于目录挂载，能确保容器使用生产环境的config.php。

二、彻底禁用Moodle邮件发送 #

方法1：修改config.php直接禁用（最可靠） #

在生产环境的config.php中添加以下配置，覆盖数据库中的邮件设置：

// 完全禁用所有邮件发送
$CFG->noemailever = true;
// 禁用通知类邮件
$CFG->disableemailnotifications = true;

修改后重启Moodle容器，该配置会直接阻止所有邮件发出，无需依赖环境变量。

方法2：修正环境变量生效逻辑（若坚持用环境变量） #

若镜像自带的config.php未读取MOODLE_DISABLE_SENDING_EMAIL变量，需手动添加映射逻辑：
进入容器编辑config.php：

docker exec -it your-moodle-container-name nano /var/www/html/config.php

添加以下代码：

if (getenv('MOODLE_DISABLE_SENDING_EMAIL') === '1') {
    $CFG->noemailever = true;
    $CFG->disableemailnotifications = true;
}

保存后重启容器，环境变量即可生效。

方法3：用假SMTP服务拦截邮件（适合需要查看邮件内容的测试） #

添加Mailhog服务拦截所有邮件，不会发送给真实用户，同时可查看邮件内容：
在docker-compose.yml中新增服务：

services:
  moodle:
    # 原moodle配置
    environment:
      # 覆盖Moodle的SMTP配置
      - MOODLE_SMTP_HOST=mailhog
      - MOODLE_SMTP_PORT=1025
  mailhog:
    image: mailhog/mailhog
    ports:
      - "8025:8025" # 访问localhost:8025查看拦截的邮件

重启容器后，Moodle发送的所有邮件会被Mailhog拦截，可通过Web界面查看，不影响真实用户。

三、额外检查：数据库中的邮件配置 #

由于导入了生产环境数据库，需确认数据库中是否存在未覆盖的SMTP配置：

1. 进入Moodle后台 -> 站点管理 -> 服务器 -> 邮件
2. 确认邮件发送方式设置为禁用或指向Mailhog的SMTP服务
3. 若无法进入后台，可直接修改数据库config表，将smtphosts、smtpport等字段改为Mailhog地址或清空。

内容的提问来源于stack exchange，提问作者SeNTiHaDeS