本文介绍使用 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 邮件附件的核心方法。它简化流程、增强健壮性，并符合无状态服务设计原则——真正做到了“生成即发送”。
