通过配置php.ini中的mail.log可记录邮件调用日志；2. 自定义函数可在mail()调用后记录收件人、主题及发送状态；3. 使用phpmailer等库时可开启smtpdebug并重定向输出到文件；4. 邮件未送达需检查sendmail服务、系统邮件日志、dns解析及spf记录；5. 应配置logrotate对日志进行每日轮转，避免文件过大影响性能。
如果您在使用PHP发送邮件后，需要追踪邮件是否成功发出或排查发送失败的原因，可以通过记录邮件日志来实现。以下是几种常见的PHP邮件日志记录方法及问题排查步骤：
一、启用PHP内置mail函数的日志功能
通过配置php.ini文件中的mail.log参数，可以让PHP自动记录所有通过mail()函数发起的邮件调用信息，包括调用时间、脚本路径等。
1、打开服务器上的php.ini文件，找到或添加mail.log配置项。
2、设置日志路径，例如：mail.log = /var/log/php_mail.log。
立即学习“PHP免费学习笔记（深入）”；
3、保存并重启Web服务（如Apache或Nginx）使配置生效。
4、执行邮件发送脚本后，检查指定日志文件中是否有相关记录。
二、使用自定义日志记录函数
在调用mail()函数前后手动写入日志，可以更灵活地控制记录内容，如收件人、主题、发送状态等。
1、定义一个日志写入函数，示例代码如下：
function logMail($to, $subject, $result) { $log = date('Y-m-d H:i:s') . " | To: $to | Subject: $subject | Sent: " . ($result ? 'Success' : 'Failed') . "\n"; file_put_contents('/var/log/php_custom_mail.log', $log, FILE_APPEND); }
2、在调用mail()函数后立即调用该函数记录结果。
3、确保日志目录存在且PHP进程有写权限。
三、利用SMTP库自带的日志机制
使用PHPMailer或SwiftMailer等第三方库时，这些库通常提供内置的日志输出选项，可用于调试邮件发送过程。
1、以PHPMailer为例，在实例化对象后开启调试模式：$mail->SMTPDebug = 2;。
2、将调试输出重定向到文件，可通过捕获输出缓冲实现：
ob_start();
$mail->send();
$debugOutput = ob_get_contents();
ob_end_clean();
file_put_contents('/var/log/phpmailer_debug.log', $debugOutput, FILE_APPEND);
四、检查邮件未送达的常见问题
即使日志显示邮件已提交，仍可能因多种原因未能实际送达收件箱。需结合日志和系统状态进行排查。
1、确认sendmail或SMTP服务正在运行，Linux下可执行systemctl status sendmail或systemctl status postfix检查。
2、查看系统邮件日志，通常位于/var/log/mail.log或/var/log/messages，搜索目标邮箱地址查找投递状态。
3、检查DNS解析是否正常，特别是MX记录，可使用nslookup -type=mx example.com测试。
4、验证发件人邮箱域名SPF记录是否包含当前服务器IP，防止被标记为伪造邮件。
五、设置独立的日志轮转策略
为避免邮件日志文件过大影响系统性能，应配置日志轮转机制定期归档或清理旧日志。
1、创建日志轮转配置文件，如/etc/logrotate.d/php_mail，内容示例：
/var/log/php_mail.log {
daily
missingok
rotate 7
compress
delaycompress
notifempty
create 640 www-data adm
}
2、测试配置是否正确：logrotate -d /etc/logrotate.d/php_mail。
3、系统会自动按周期执行轮转，无需手动干预。
