如何使用 PHPMailer 正确附加 MySQL 数据库备份文件并发送邮件-php教程-PHP中文网

如何使用 PHPMailer 正确附加 MySQL 数据库备份文件并发送邮件

本文详解如何在生成 PDO MySQL 数据库备份（支持 .sql 或 .sql.gz 压缩格式）后，通过 PHPMailer 成功将备份文件作为附件发送至指定邮箱，重点解决“附件未送达”这一常见问题。

本文详解如何在生成 pdo mysql 数据库备份（支持 `.sql` 或 `.sql.gz` 压缩格式）后，通过 phpmailer 成功将备份文件作为附件发送至指定邮箱，重点解决“附件未送达”这一常见问题。

在实际运维中，自动备份数据库并通过邮件通知是关键环节。但许多开发者遇到类似问题：备份文件成功生成（如 my_website_2024_05_20_14_30_22.sql.gz），却始终无法通过 PHPMailer 附加到邮件中——邮件正常发出，附件却为空。根本原因通常在于路径不一致、文件未及时关闭、或 AddAttachment() 调用时机错误。

以下为经过验证的修复要点与完整实践方案：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

✅ 关键修复点说明

确保 $save_string 是完整、可访问的绝对/相对路径
原代码中 $save_string = $config['SAVE_AS'] . $config['SAVE_DIR'] . date(...), 但 $config['SAVE_DIR'] 初始化为空字符串（''），而 $save_dir = './' 未被传入配置。导致生成路径如 my_website_2024_05_20_14_30_22.sql.gz（无目录前缀），而 AddAttachment() 查找时可能因工作目录差异失败。
✅ 修正方式：统一使用明确路径，例如：
```
$save_dir = __DIR__ . '/backups/'; // 推荐绝对路径
if (!is_dir($save_dir)) mkdir($save_dir, 0755, true);
$save_string = $save_dir . $file_name_prefix . date('Y_m_d_H_i_s') . ($do_compress ? '.sql.gz' : '.sql');
```
必须在调用 AddAttachment() 前完成文件写入并关闭句柄
原函数中 gzclose($zp) 或 fclose($handle) 执行于 return 之前，看似正确；但若函数返回后立即调用 AddAttachment($save_string)，而文件系统缓存未刷新或进程未完全释放，PHPMailer 可能读取失败。
✅ 强化保障：添加文件存在性与可读性校验：
```
if (!file_exists($save_string) || !is_readable($save_string)) {
    throw new Exception("Backup file not found or unreadable: {$save_string}");
}
```
PHPMailer 配置需启用 addAttachment() 的完整路径 + 显式文件名
AddAttachment($path) 接收两个参数：$path（本地路径）和可选的 $name（邮件中显示的文件名）。建议显式指定，避免 MIME 类型识别异常：
```
$attachmentName = basename($save_string); // 如 'my_website_2024_05_20_14_30_22.sql.gz'
if (!$mail->addAttachment($save_string, $attachmentName)) {
    echo "Attachment failed: " . $mail->ErrorInfo;
    exit;
}
```
注意 PHPMailer 版本兼容性
原代码使用旧版 class.phpmailer.php（v5.x），其方法名为 AddAttachment()（首字母大写）；新版 PHPMailer（v6+）已改为 addAttachment()（小驼峰）。本文示例基于 v6.x（推荐升级），若沿用旧版，请保持方法名大小写一致。

✅ 完整整合示例（精简核心逻辑）

// 1. 生成备份（修正后的 backupDB 函数返回绝对路径）
$backup_config = [
    'DB_HOST' => $db_server,
    'DB_NAME' => $db_name,
    'DB_USERNAME' => $db_user,
    'DB_PASSWORD' => $db_pass,
    'INCLUDE_DROP_TABLE' => false,
    'SAVE_DIR' => __DIR__ . '/backups/', // ✅ 绝对路径
    'SAVE_AS' => $file_name_prefix,
    'APPEND_DATE_FORMAT' => 'Y_m_d_H_i_s',
    'TIMEZONE' => 'Asia/Kolkata',
    'COMPRESS' => true,
];

$backupPath = backupDB($backup_config); // 此函数内部应返回 $save_string（完整路径）

// 2. 发送邮件
$mail = new PHPMailer\PHPMailer\PHPMailer(true); // 启用异常抛出
try {
    $mail->isSMTP();
    $mail->Host       = constant('EMAILHOST');
    $mail->SMTPAuth   = constant('SMTPAuth');
    $mail->Username   = constant('SMTPUSERNAME');
    $mail->Password   = constant('SMTPPASSWORD');
    $mail->SMTPSecure = PHPMailer\PHPMailer\PHPMailer::ENCRYPTION_STARTTLS;
    $mail->Port       = 587;

    $mail->setFrom(constant('FROMEMAIL'), constant('FROMNAME'));
    $mail->addAddress($mail_to1, $mail_to1_name);

    $mail->isHTML(true);
    $mail->Subject = '[' . constant('FROMNAME') . '] MySQL Backup - ' . date('d-M-Y H:i:s');
    $mail->Body    = "Database backup completed successfully. File attached.";

    // ✅ 关键：验证文件 + 附加
    if (!file_exists($backupPath) || !is_readable($backupPath)) {
        throw new Exception("Backup file inaccessible: {$backupPath}");
    }
    $mail->addAttachment($backupPath, basename($backupPath));

    $mail->send();
    echo "✅ Email sent with attachment: " . basename($backupPath);
} catch (Exception $e) {
    echo "❌ Mailer Error: {$mail->ErrorInfo}";
}

⚠️ 注意事项与最佳实践

权限与路径安全：backups/ 目录不可置于 Web 可访问路径（如 public_html 下），防止恶意下载。建议存放于 ../private-backups/ 并设置 .htaccess 或 Nginx deny all。
大文件限制：Gmail 等服务商限制附件 ≤25MB。若备份过大，考虑改用云存储（如 AWS S3）并邮件发送下载链接。
错误日志：生产环境务必记录 backupDB() 和邮件发送的完整日志（含时间戳、文件大小、MD5 校验），便于审计与故障排查。
资源清理：发送成功后，可选择保留或自动清理备份文件（unlink($backupPath)），避免磁盘占满。

通过以上结构化修正，即可稳定实现「自动备份 → 本地落盘 → 邮件附件发送」全链路闭环。核心在于路径可控、状态可验、调用有序——告别“邮件发了，附件没了”的隐形陷阱。