在Docker容器中配置PHP邮件发送功能的问题

1. 是否需要添加自定义ini文件？ #

需要。php:8.3-fpm-alpine3.19镜像默认不会加载主php.ini文件，而是通过/usr/local/etc/php/conf.d/目录下所有.ini后缀的文件加载配置。你可以像配置Xdebug一样，新增一个邮件配置的ini文件来补充邮件相关参数。

2. 自定义ini文件的命名规则 #

只要文件名以.ini结尾即可，比如mail.ini、01-mail.ini（数字前缀可调整加载顺序，数字越小优先级越高，邮件配置一般不需要特殊顺序）。

3. 配置文件内容及配套操作 #

PHP的mail()函数在Linux环境下默认依赖sendmail类工具，因此需要分两步操作：安装邮件发送工具 + 配置ini参数。

方案一：使用sendmail

• Dockerfile中安装sendmail：

RUN apk add --no-cache sendmail

• mail.ini配置内容：

[mail function]
; 指定sendmail路径
sendmail_path = /usr/sbin/sendmail -t -i
; 可选：设置默认发件人地址
sendmail_from = your-default-sender@example.com

方案二：使用SMTP（适配第三方邮件服务，推荐）

如果需要用阿里云邮箱、Gmail等第三方SMTP服务发送邮件，推荐用msmtp替代sendmail：

• Dockerfile中安装msmtp：

RUN apk add --no-cache msmtp

• mail.ini配置内容：

[mail function]
sendmail_path = /usr/bin/msmtp -t

• 新增msmtp配置文件（比如/etc/msmtprc），可在Dockerfile中添加：

RUN echo -e "defaults\nauth on\ntls on\ntls_starttls on\ntls_trust_file /etc/ssl/certs/ca-certificates.crt\naccount default\nhost smtp.example.com\nport 587\nuser your-account@example.com\npassword your-auth-code\nfrom your-account@example.com" > /etc/msmtprc
RUN chmod 600 /etc/msmtprc

注意：将上述配置中的smtp.example.com、your-account@example.com、your-auth-code替换为实际的SMTP服务器地址、邮箱账号和授权码（部分邮箱需使用授权码而非登录密码）。

4. 测试邮件发送 #

编写简单的PHP脚本测试：

<?php
$to = 'test-recipient@example.com';
$subject = 'Docker PHP 邮件测试';
$message = '这是来自Docker容器的测试邮件';
$headers = 'From: your-default-sender@example.com' . "\r\n" .
           'Reply-To: your-default-sender@example.com';

if (mail($to, $subject, $message, $headers)) {
    echo '邮件发送成功';
} else {
    echo '邮件发送失败';
}
?>

额外建议 #

如果项目使用PHPMailer、SwiftMailer等第三方邮件库，无需修改php.ini，直接在代码中配置SMTP参数即可，这种方式更灵活且易于维护。

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