本文介绍使用 PHPMailer 的 addStringAttachment() 方法，将内存中生成的 CSV 数据直接作为邮件附件发送，无需先写入临时文件或上传到服务器，提升性能与安全性。

本文介绍使用 phpmailer 的 `addstringattachment()` 方法，将内存中生成的 csv 数据直接作为邮件附件发送，无需先写入临时文件或上传到服务器，提升性能与安全性。

在 Web 开发中，常需动态生成报表（如用户导出数据）并以 CSV 格式通过邮件发送。传统做法是先用 fputcsv() 将数据写入临时文件（如 /tmp/report.csv），再调用 addAttachment() 加载该文件——这不仅增加 I/O 开销，还可能引发权限、清理和并发问题。

PHPMailer 提供了更优雅的解决方案：addStringAttachment() 方法。它允许你将纯字符串内容（如 CSV 内容）直接附加为邮件附件，跳过文件系统操作。只需将 CSV 数据组装为符合 RFC 4180 规范的字符串，并指定文件名与 MIME 类型即可。

✅ 示例代码（基于 PHPMailer v6.9+）：

QuickBooks Mileage CSV

使用 qbo-mileage CLI 及用户凭证，从 Airtable、Outlook 或 Google Calendar 记录生成 QuickBooks Online 里程 CSV 文件。

下载

use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\Exception;

$mail = new PHPMailer(true);
try {
    $mail->isSMTP();
    $mail->Host       = 'smtp.example.com';
    $mail->SMTPAuth   = true;
    $mail->Username   = 'user@example.com';
    $mail->Password   = 'app-password';
    $mail->SMTPSecure = 'tls';
    $mail->Port       = 587;

    $mail->setFrom('from@example.com', 'System');
    $mail->addAddress('to@example.com');

    $mail->isHTML(false);
    $mail->Subject = 'Your CSV Report';
    $mail->Body    = "Please find the attached CSV report.";

    // ✨ 动态生成 CSV 内容（内存中）
    $data = [
        ['Name', 'Email', 'Joined'],
        ['Alice Johnson', 'alice@example.com', '2024-01-15'],
        ['Bob Smith', 'bob@example.com', '2024-02-03']
    ];

    $csv = '';
    $output = fopen('php://memory', 'r+');
    foreach ($data as $row) {
        fputcsv($output, $row);
    }
    rewind($output);
    $csv = stream_get_contents($output);
    fclose($output);

    // ✨ 直接附加 CSV 字符串（无需保存文件！）
    $mail->addStringAttachment($csv, 'report.csv', 'base64', 'text/csv');

    $mail->send();
    echo "Email sent with inline CSV attachment.";
} catch (Exception $e) {
    echo "Message could not be sent. Mailer Error: {$mail->ErrorInfo}";
}

⚠️ 注意事项：

• 确保 CSV 内容使用 UTF-8 编码；如含中文等多字节字符，建议在 fputcsv 前统一转码（例如 mb_convert_encoding($row, 'UTF-8', 'auto')）；
• 第三个参数 'base64' 是推荐编码方式，确保二进制安全传输；也可选 'quoted-printable'；
• 文件名（第二个参数）应包含 .csv 扩展名，便于客户端正确识别；
• 大数据量时注意内存限制（memory_limit），必要时可分块生成或改用流式处理（PHPMailer 当前暂不支持原生流附件，但 addStringAttachment 对几 MB 数据仍高效可靠）。

总结：addStringAttachment() 是实现“零磁盘写入”CSV 邮件附件的核心方法。它简化流程、增强健壮性，并符合无状态服务设计原则——真正做到了“生成即发送”。