PHPMailer附件发送失败解决方法

从现在开始，我们要努力学习啦！今天我给大家带来《PHPMailer附件发送失败解决方法》，感兴趣的朋友请继续看下去吧！下文中的内容我们主要会涉及到等等知识点，如果在阅读本文过程中有遇到不清楚的地方，欢迎留言呀！我们一起讨论，一起学习！

在开发Web应用程序时，我们经常会遇到需要动态生成文件（如PDF、图片证书等）并将其作为电子邮件附件发送的场景。PHPMailer是一个功能强大的PHP邮件发送库，但如果不注意文件生成与附件添加的执行顺序，可能会遇到附件首次发送失败，而刷新页面后却能成功发送的“奇怪”现象。

问题分析：文件访问时序错误

这种现象的根本原因在于PHP脚本的执行顺序。当一个PHP脚本同时负责生成文件和发送邮件时，如果邮件发送逻辑（特别是附件添加部分）在文件生成并保存到磁盘之前执行，PHPMailer将无法找到或访问该文件，从而导致附件发送失败。

首次提交表单时：

1. 用户提交表单。
2. PHP脚本开始执行。
3. PHPMailer尝试添加附件。
4. 此时，生成附件的图像处理代码（如imagepng()）尚未执行完毕或文件尚未完全写入磁盘。
5. PHPMailer报错，指示无法访问文件。

刷新页面时：

1. 页面刷新（通常意味着再次提交表单或重新加载脚本）。
2. PHP脚本再次执行。
3. 由于第一次尝试时，图像生成代码已经执行并将文件保存到了磁盘。
4. PHPMailer再次尝试添加附件时，文件已经存在于指定路径。
5. PHPMailer成功找到并附加文件，邮件发送成功。

这表明问题并非出在PHPMailer本身或文件路径错误，而是文件在PHPMailer尝试访问时还未就绪。

解决方案：调整代码执行顺序

解决此问题的关键在于确保文件生成和保存操作在PHPMailer尝试添加该文件作为附件之前完成。这意味着，生成证书图片并将其保存到指定路径的代码必须在PHPMailer的AddAttachment()方法调用之前执行。

以下是修正后的PHP代码结构示例，展示了正确的执行顺序：

<?php
// 引入PHPMailer类和设置文件
use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\SMTP;
use PHPMailer\PHPMailer\Exception;

require 'PHPMailer-master/src/PHPMailer.php';
require 'PHPMailer-master/src/SMTP.php';
require 'PHPMailer-master/src/Exception.php';

include 'settings.php'; // 包含设置文件

// 检查表单是否提交
if (isset($_POST['generate'])) {
    // 获取表单数据
    $name = ucwords($_POST['name']);
    $customerref = ($_POST['customerref']);
    $date = ($_POST['date']);
    $customeremail = ($_POST['customeremail']);
    $weight = ucwords($_POST['weight']);

    // 输入验证
    if ($name == "" || $weight == "" || $date == "" || $customeremail == "" || $customerref == "") {
        echo "<div class='alert alert-danger col-sm-6' role='alert'>并非所有表单字段都已填写。请重试。</div>";
    } else {
        // 提示信息
        echo "<div class='alert alert-success col-sm-6' role='alert'>恭喜！$name 的证书已生成并发送至 $customeremail。</div>";

        // --- 第一步：生成并保存证书图片 ---
        $image = "CSD-Certificates/certi.png";
        $createimage = imagecreatefrompng($image);

        $output = dirname(__FILE__) . "/CSD-Certificates/saved-certs/destruction-cert($customerref-$date).png";

        $white = imagecolorallocate($createimage, 254, 254, 254);
        $black = imagecolorallocate($createimage, 0, 0, 0);
        $rotation = 0;

        // 字体路径
        $drFont = "CSD-Certificates/TitilliumWeb-Regular.ttf";

        // 根据名称长度调整字体大小和位置
        $name_len = strlen($_POST['name']);
        $font_size = 50;
        $origin_x = 1600;
        if ($name_len > 7 && $name_len <= 12) { $font_size = 40; }
        elseif ($name_len > 12 && $name_len <= 15) { $font_size = 40; }
        // ... 其他长度判断

        // 写入文本到图片
        imagettftext($createimage, $font_size, $rotation, $origin_x, 700, $white, $drFont, $name);
        imagettftext($createimage, 50, $rotation, 2302, 900, $white, $drFont, $weight);
        imagettftext($createimage, $font_size, $rotation, 1850, 900, $white, $drFont, $date);
        imagettftext($createimage, $font_size, $rotation, 2200, 1980, $white, $drFont, $date);
        imagettftext($createimage, $font_size, $rotation, 2200, 2180, $white, $drFont, $customerref);

        // 保存生成的图片文件
        imagepng($createimage, $output, 3);
        // 释放内存
        imagedestroy($createimage);

        // --- 第二步：使用PHPMailer发送邮件 ---
        $mail = new PHPMailer(true); // 启用异常

        try {
            // 服务器设置
            $mail->isSMTP();
            $mail->Host       = 'mail.smtp2go.com';
            $mail->SMTPAuth   = true;
            $mail->Username   = 'refurbsa.com';
            $mail->Password   = 'Y2F6ejMxbGFseTUw';
            $mail->SMTPSecure = PHPMailer::ENCRYPTION_SMTPS;
            $mail->Port       = 465;

            // 收件人
            $mail->setFrom('sender@example.com', 'Electronic Cemetery');
            $mail->addAddress($customeremail); // 使用从表单获取的邮箱
            $mail->addReplyTo('replyto@example.com', 'Electronic Cemetery');

            // 添加附件 (确保 $output 路径的文件已存在)
            $mail->AddAttachment($output);

            // 内容
            $mail->isHTML(true);
            $mail->Subject = '您的电子废物处理证书';
            $mail->Body    = "您好 $name,<br><br>
感谢您使用我们的服务。您的回收请求已处理，我们已将销毁证书附加到此电子邮件中。
<br><br>
如果您对我们的服务感到满意，请花一点时间在 <a href='https://www.facebook.com/eastcoastewaste/reviews'>这里</a> 给予我们评价，我们将不胜感激。
<br><br>
我们期待未来能继续协助您处理所有电子废物需求。
<br><br>
祝您有美好的一天！
<br><br>
电子墓地团队";

            $mail->send();
        } catch (Exception $e) {
            echo "邮件无法发送。Mailer Error: {$mail->ErrorInfo}";
        }
    }
}
?>

在上述代码中，关键的改动是将 imagepng($createimage, $output, 3); 这行代码（负责保存图片文件）放置在 PHPMailer 的 AddAttachment() 方法调用之前。这样，当 PHPMailer 尝试添加附件时，目标文件已经确保存在于文件系统中。

注意事项

1. 文件路径的准确性： 确保 dirname(__FILE__)."/CSD-Certificates/saved-certs/destruction-cert($customerref-$date).png" 生成的路径是正确的，并且PHP脚本对该路径有写入和读取权限。
2. 错误处理： PHPMailer的try-catch块对于捕获邮件发送过程中的错误至关重要。同时，图像生成过程中也应考虑错误处理，例如检查imagecreatefrompng()是否成功。
3. 内存管理： 对于图像处理，在imagepng()之后使用imagedestroy($createimage);释放图像资源是一个良好的习惯，尤其是在处理大量图片时，可以避免内存溢出。
4. 文件命名： 确保生成的文件名是唯一的，或者至少不会在短时间内重复，以避免文件覆盖问题。在此例中，$customerref-$date的组合有助于创建唯一的文件名。
5. 异步处理（高级）： 对于高并发或耗时长的文件生成任务，可以考虑将文件生成和邮件发送分离，例如使用消息队列进行异步处理。但这通常超出了简单Web表单提交的范畴。

总结

PHPMailer附件发送首次失败、刷新后成功的现象，本质上是文件生成与附件引用之间的时序问题。通过简单地调整代码执行顺序，确保附件文件在被PHPMailer访问之前已经完全生成并保存，即可有效解决此问题。理解并遵循正确的执行流程，是构建稳定可靠的PHP应用程序的关键。

好了，本文到此结束，带大家了解了《PHPMailer附件发送失败解决方法》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！