如何在Docker容器中使用PHP mail()函数发送邮件

一、sendmail与PHPMailer的适用性 #

• sendmail可配合PHP原生mail()函数使用，但需要在容器内安装sendmail服务并配置PHP参数
• PHPMailer是更可靠的第三方邮件库，无需依赖sendmail，直接通过SMTP发送，配置灵活、兼容性强，推荐用于生产环境，完全能替代mail()的功能

二、使用sendmail配置PHP mail()函数 #

1. 修改Dockerfile安装依赖并配置 #

更新你的Dockerfile，添加sendmail安装和PHP配置：

FROM php:8.2-apache
RUN a2enmod rewrite
RUN a2enmod include

# 安装sendmail及依赖工具
RUN apt-get update && apt-get install -y sendmail procps && \
    # 初始化sendmail配置
    sendmailconfig && \
    # 配置PHP的sendmail路径
    echo "sendmail_path = /usr/sbin/sendmail -t -i" >> /usr/local/etc/php/conf.d/sendmail.ini

ENV PORT=80

2. 启动容器时启动sendmail服务 #

sendmail服务默认不会随容器启动，需手动触发启动，有两种方式：

• 方式一：在Dockerfile中添加启动命令
  在Dockerfile末尾追加：

CMD service sendmail start && apache2-foreground

• 方式二：启动容器时指定命令
  执行以下命令启动容器：

docker run -d -p 80:80 --name php-apache your-image-tag bash -c "service sendmail start && apache2-foreground"

3. Windows宿主机特殊配置 #

Windows宿主机无内置邮件传输代理（MTA），容器内的sendmail需要通过外部SMTP中继才能发信：

• 编辑容器内/etc/mail/sendmail.mc文件，添加SMTP中继配置（比如QQ邮箱、163邮箱的SMTP服务器信息）
• 执行m4 /etc/mail/sendmail.mc > /etc/mail/sendmail.cf生成生效配置，重启sendmail服务

三、使用PHPMailer（推荐方案） #

PHPMailer无需依赖sendmail，直接通过SMTP对接邮件服务商，配置更简单，问题排查更直观。

1. 安装PHPMailer #

方式一：容器内手动安装

进入容器执行以下命令：

docker exec -it your-container-name bash
# 安装Composer
curl -sS https://getcomposer.org/installer | php
mv composer.phar /usr/local/bin/composer
# 进入项目目录安装PHPMailer
cd /var/www/html
composer require phpmailer/phpmailer

方式二：集成到Dockerfile

直接在构建镜像时完成安装：

FROM php:8.2-apache
RUN a2enmod rewrite
RUN a2enmod include

# 安装Composer
RUN curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer

# 安装PHPMailer（假设项目代码挂载到/var/www/html）
WORKDIR /var/www/html
RUN composer require phpmailer/phpmailer

ENV PORT=80

2. PHP代码示例 #

在项目中编写发送邮件的脚本：

<?php
use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\Exception;

require 'vendor/autoload.php';

$mail = new PHPMailer(true);

try {
    // SMTP服务器配置
    $mail->isSMTP();
    $mail->Host       = 'smtp.qq.com'; // 替换为你的邮箱SMTP服务器
    $mail->SMTPAuth   = true;
    $mail->Username   = 'your-email@qq.com'; // 你的邮箱账号
    $mail->Password   = 'your-auth-code'; // 邮箱授权码（非登录密码）
    $mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;
    $mail->Port       = 587;

    // 收件人设置
    $mail->setFrom('your-email@qq.com', 'Your Name');
    $mail->addAddress('recipient@example.com', 'Recipient');

    // 邮件内容
    $mail->isHTML(true);
    $mail->Subject = 'Docker PHP Test Email';
    $mail->Body    = '<h3>测试邮件</h3><p>这是从Docker容器中通过PHPMailer发送的邮件</p>';
    $mail->AltBody = '测试邮件：这是从Docker容器中通过PHPMailer发送的邮件';

    $mail->send();
    echo '邮件发送成功';
} catch (Exception $e) {
    echo "发送失败：{$mail->ErrorInfo}";
}
?>

3. Windows宿主机注意事项 #

• 确保宿主机防火墙允许访问SMTP服务器的端口（如587、465）
• 提前在邮箱服务商处开启SMTP服务，并获取授权码（不要用登录密码）

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