PHPMailer附件上传失败解决办法

来到golang学习网的大家，相信都是编程学习爱好者，希望在这里学习文章相关编程知识。下面本篇文章就来带大家聊聊《PHPMailer附件上传失败解决方法》，介绍一下，希望对大家的知识积累有所帮助，助力实战开发！

本文详解 PHPMailer 中“Could not access file”错误的成因与修复方法，涵盖安全文件上传验证、临时路径处理、版本升级建议及最佳实践代码示例。

在使用 PHPMailer 发送带附件的邮件时，出现重复报错 Could not access file（如 Could not access file: Could not access file: Could not access file: PHP Mailer issue），通常并非 PHPMailer 本身缺陷，而是文件上传未经过安全校验与正确落盘所致。原始代码直接将 $_FILES["attachment"]["tmp_name"][$k] 传入 AddAttachment()，但 PHP 的临时上传文件具有生命周期短、权限受限、多文件索引易错等特性，一旦 tmp_name 无效或路径不可读，即触发该错误。

✅ 正确做法：先验证并移动上传文件，再附加

PHP 官方文档与现代 PHPMailer 均强调：绝不能直接使用 $_FILES['...']['tmp_name'] 作为附件源路径。必须通过 move_uploaded_file() 显式转移文件至可信位置，并验证操作结果：

// ✅ 安全处理单个/多个附件（支持多文件上传）
$uploadFiles = [];
foreach ($_FILES["attachment"]["error"] as $k => $error) {
    if ($error === UPLOAD_ERR_OK) {
        $originalName = $_FILES["attachment"]["name"][$k];
        $tmpPath      = $_FILES["attachment"]["tmp_name"][$k];
        $ext          = pathinfo($originalName, PATHINFO_EXTENSION);
        $safeName     = bin2hex(random_bytes(16)) . '.' . strtolower($ext); // 防止恶意扩展名
        $uploadPath   = sys_get_temp_dir() . '/' . $safeName;

        if (move_uploaded_file($tmpPath, $uploadPath)) {
            $uploadFiles[] = [
                'path' => $uploadPath,
                'name' => $originalName
            ];
        } else {
            $_SESSION["error"] = "Failed to save uploaded file: {$originalName}";
            exit;
        }
    }
}

// ✅ 初始化新版 PHPMailer（推荐 v6.9+）
use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\SMTP;
use PHPMailer\PHPMailer\Exception;

require 'vendor/autoload.php'; // Composer 自动加载（替代旧版 class.phpmailer.php）

$mail = new PHPMailer(true); // 启用异常模式
try {
    $mail->isSMTP();
    $mail->Host       = 'webs10rdns1.websouls.net';
    $mail->SMTPAuth   = true;
    $mail->Username   = 'your-email@domain.com';
    $mail->Password   = 'Guildsconnect';
    $mail->SMTPSecure = PHPMailer::ENCRYPTION_SMTPS; // 替代已废弃的 "ssl"
    $mail->Port       = 465;

    $mail->setFrom($contact_email, $contact_name);
    $mail->addReplyTo($contact_email, $contact_name);
    $mail->addAddress('recipient@example.com');
    $mail->Subject = $sub1;
    $mail->isHTML(true);
    $mail->Body    = $emailbodyis;

    // ✅ 逐个附加已安全保存的文件
    foreach ($uploadFiles as $file) {
        $mail->addAttachment($file['path'], $file['name']);
    }

    $mail->send();
    $_SESSION["success"] = "Mail sent successfully with " . count($uploadFiles) . " attachment(s).";

} catch (Exception $e) {
    $_SESSION["error"] = "Mailer Error: " . $mail->ErrorInfo;
} finally {
    // ✅ 清理临时文件（发送后立即删除，避免磁盘占用）
    foreach ($uploadFiles as $file) {
        @unlink($file['path']);
    }
}

⚠️ 关键注意事项

• 务必升级 PHPMailer：原始代码使用已废弃的 class.phpmailer.php（v5.x 以前），存在严重安全漏洞且不兼容 PHP 7.4+。请通过 Composer 安装最新稳定版（composer require phpmailer/phpmailer）。
• 禁用 Mailer = "smtp" 手动设置：调用 $mail->isSMTP() 后自动配置 SMTP 模式，显式赋值反而可能干扰内部逻辑。
• 多文件上传需遍历 error 数组：$_FILES["attachment"]["error"] 是判断每个文件是否上传成功的唯一可靠依据，而非仅依赖 tmp_name 是否非空。
• 临时文件必须显式清理：即使使用 tempnam()，也应在邮件发送完成后调用 unlink()，防止 /tmp 目录堆积。
• 禁止信任客户端文件名：原始文件名可能含路径遍历（如 ../etc/passwd）或危险扩展（.php）。应剥离后缀并生成随机安全名。

遵循以上流程，即可彻底解决 Could not access file 错误，同时显著提升应用安全性与健壮性。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。