非Composer环境下PHPMailer多附件表单发送故障求助

一、是否需要手动创建临时文件夹？ #

不需要。sys_get_temp_dir()会自动返回虚拟主机系统默认的临时目录，该目录通常具备读写权限，无需手动创建。你的问题核心不在临时文件夹，而是代码和环境配置的细节问题。

二、关键代码修复与优化 #

1. 补充表单enctype属性 #

HTML表单上传文件必须声明enctype="multipart/form-data"，否则文件根本不会被后端接收。修改表单标签：

<form method="post" enctype="multipart/form-data">
    <!-- 你的现有表单内容 -->
</form>

2. 开启PHPMailer调试模式（排查无日志问题） #

当前错误日志无记录，可开启SMTP调试模式获取详细报错信息，调试完成后关闭即可：

$mail = new PHPMailer(true); // 启用异常处理
$mail->SMTPDebug = SMTP::DEBUG_SERVER; // 输出SMTP交互日志

3. 简化附件添加逻辑（避免移动文件权限问题） #

无需移动上传的临时文件，PHPMailer支持直接读取系统临时目录中的上传文件，减少权限风险：

if (array_key_exists('attachFile', $_FILES)) {
    for ($ct = 0, $ctMax = count($_FILES['attachFile']['tmp_name']); $ct < $ctMax; $ct++) {
        // 跳过未成功上传的文件
        if (!isset($_FILES['attachFile']['tmp_name'][$ct]) || !is_uploaded_file($_FILES['attachFile']['tmp_name'][$ct])) {
            $msg .= '跳过无效文件：' . $_FILES['attachFile']['name'][$ct] . "\n";
            continue;
        }
        // 直接用临时文件路径添加附件
        if (!$mail->addAttachment(
            $_FILES['attachFile']['tmp_name'][$ct],
            $_FILES['attachFile']['name'][$ct]
        )) {
            $msg .= '添加附件失败：' . $_FILES['attachFile']['name'][$ct] . "\n";
        }
    }
}

4. 完善SMTP配置（解决连接/加密问题） #

虚拟主机SMTP通常需要指定端口与加密方式，补充以下配置：

$mail->Port = 465; // 常用SSL端口，也可尝试587（TLS）
$mail->SMTPSecure = PHPMailer::ENCRYPTION_SMTPS; // 对应465端口的SSL加密
// 若用587端口，替换为：
// $mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;
$mail->SMTPAuth = true; // 必须开启SMTP认证

5. 统一邮件逻辑与错误输出 #

将邮件初始化移至全局，覆盖有/无附件的场景，并确保错误信息可见：

// 全局初始化PHPMailer
$mail = new PHPMailer(true);
try {
    $mail->IsSMTP();
    $mail->Host = 'mail.domain.com';
    $mail->Username = 'form@domain.com';
    $mail->Password = 'password';
    $mail->setFrom('form@domain.com');
    $mail->AddAddress('user@domain.com');
    $mail->Subject = "Info Request";
    $mail->Body = $msg;
    $mail->WordWrap = 50;
    $mail->Port = 465;
    $mail->SMTPSecure = PHPMailer::ENCRYPTION_SMTPS;
    $mail->SMTPAuth = true;

    // 处理附件
    if (array_key_exists('attachFile', $_FILES)) {
        for ($ct = 0, $ctMax = count($_FILES['attachFile']['tmp_name']); $ct < $ctMax; $ct++) {
            if (!isset($_FILES['attachFile']['tmp_name'][$ct]) || !is_uploaded_file($_FILES['attachFile']['tmp_name'][$ct])) {
                $msg .= '跳过无效文件：' . $_FILES['attachFile']['name'][$ct] . "\n";
                continue;
            }
            if (!$mail->addAttachment(
                $_FILES['attachFile']['tmp_name'][$ct],
                $_FILES['attachFile']['name'][$ct]
            )) {
                $msg .= '添加附件失败：' . $_FILES['attachFile']['name'][$ct] . "\n";
            }
        }
    }

    $mail->send();
    $msg .= '邮件发送成功！';
} catch (Exception $e) {
    $msg .= '邮件发送失败：' . $mail->ErrorInfo;
}

// 在页面输出日志，方便排查
echo '<pre>' . $msg . '</pre>';

三、虚拟主机环境排查 #

• 上传大小限制：检查php.ini中的upload_max_filesize和post_max_size，若附件超过限制会导致上传失败。
• 文件类型限制：部分虚拟主机会禁止上传/发送可执行文件、压缩包等类型，可尝试上传普通图片测试。
• 临时目录权限：通过var_dump(is_writable(sys_get_temp_dir()))验证临时目录是否可写。

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