本文详解如何在 PHP 中利用 DOMPDF 库将 HTML 内容渲染为 PDF，并以附件形式通过邮件自动发送，涵盖 PDF 二进制流获取、文件临时保存、PHPMailer 配置与附件集成等关键步骤。
本文详解如何在 PHP 中利用 DOMPDF 库将 HTML 内容渲染为 PDF，并以附件形式通过邮件自动发送，涵盖 PDF 二进制流获取、文件临时保存、PHPMailer 配置与附件集成等关键步骤。
在 Web 开发中，常需将动态生成的 HTML 报表（如发票、订单确认单）转换为 PDF 并自动发送至用户邮箱。DOMPDF 是一个轻量、兼容性良好的 PHP HTML-to-PDF 渲染库，但其 stream() 方法仅用于浏览器下载，不返回可复用的 PDF 二进制数据——这正是直接邮件发送失败的常见原因。正确做法是调用 output() 方法获取原始 PDF 字节流，再结合邮件组件完成附件投递。
✅ 正确流程：渲染 → 获取二进制 → 保存临时文件 → 邮件附加
以下是一个完整、可运行的示例（基于 DOMPDF v2.x + PHPMailer v6.x）：
<?php
require 'vendor/autoload.php'; // 确保已通过 Composer 安装 dompdf/dompdf 和 phpmailer/phpmailer
use Dompdf\Dompdf;
use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\SMTP;
// 1. 初始化 DOMPDF 并渲染 PDF
$dompdf = new Dompdf([
'defaultFont' => 'Helvetica',
'isRemoteEnabled' => true // 若 HTML 含远程图片（如 <img src="https://..." alt="如何使用 DOMPDF 生成 PDF 并通过邮件发送（含附件）" >），需启用
]);
$dompdf->loadHtml(html_entity_decode($output)); // $output 为你的 HTML 字符串
$dompdf->setPaper('A4', 'portrait');
$dompdf->render();
// 2. 获取 PDF 二进制内容（关键！替代 stream()）
$pdfContent = $dompdf->output();
// 3. 生成唯一临时文件名（避免并发覆盖）
$tempPdfPath = sys_get_temp_dir() . '/invoice_' . uniqid() . '.pdf';
file_put_contents($tempPdfPath, $pdfContent);
// 4. 使用 PHPMailer 发送带附件的邮件
$mail = new PHPMailer(true);
try {
$mail->isSMTP();
$mail->Host = 'smtp.gmail.com'; // 替换为你的 SMTP 服务器
$mail->SMTPAuth = true;
$mail->Username = 'your_email@gmail.com';
$mail->Password = 'your_app_password'; // Gmail 需使用应用专用密码
$mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;
$mail->Port = 587;
$mail->setFrom('your_email@gmail.com', 'Your App');
$mail->addAddress('recipient@example.com', 'Recipient Name');
$mail->Subject = 'Your Invoice is Ready (PDF Attached)';
$mail->Body = "Dear user,\n\nPlease find your invoice attached as a PDF.\n\nBest regards,\nYour Team";
// ✅ 核心：添加 PDF 附件（路径 + 自定义文件名）
$mail->addAttachment($tempPdfPath, 'Invoice_' . date('Y-m-d_H-i-s') . '.pdf');
$mail->send();
// 清理临时文件（发送成功后立即删除）
unlink($tempPdfPath);
echo "Email sent successfully with PDF attachment.";
} catch (Exception $e) {
error_log("Mailer Error: " . $mail->ErrorInfo);
echo "Message could not be sent. Mailer Error: {$mail->ErrorInfo}";
// 可选：仍尝试清理临时文件
if (file_exists($tempPdfPath)) unlink($tempPdfPath);
}
?>⚠️ 关键注意事项
- 不要用 stream() 获取内容：stream() 直接输出 HTTP 响应并终止脚本，无法捕获 PDF 数据；必须使用 output()。
- 临时文件安全处理：务必使用 sys_get_temp_dir() 和 uniqid() 生成唯一路径，并在邮件发送后（无论成功与否）调用 unlink() 删除，防止磁盘占用和敏感信息残留。
- 字体与 CSS 兼容性：DOMPDF 对 CSS 支持有限（如 Flexbox、Grid 不支持）。建议使用内联样式或基础表格布局，并预加载中文字体（如 Noto Sans CJK）以避免乱码。
-
远程资源访问：若 HTML 中引用了外部 CSS/JS/图片，请确保：
- isRemoteEnabled => true
- 服务器可访问对应 URL（检查防火墙、cURL 权限）
- 图片建议转为 Base64 或本地化以提升稳定性
- 内存与超时：大型 HTML 可能导致内存溢出或超时，可通过 ini_set('memory_limit', '512M') 和 set_time_limit(120) 调整（生产环境建议异步处理）。
✅ 替代方案（无文件落地）
若需完全避免磁盘 I/O（如无写权限环境），可借助 PHPMailer 的 addStringAttachment() 方法直接传入二进制流：
// 替代 file_put_contents + addAttachment $mail->addStringAttachment($pdfContent, 'Invoice.pdf', 'base64', 'application/pdf');
该方式跳过临时文件，更高效且安全，推荐在容器化或无状态环境中优先采用。
掌握这一流程，即可稳定实现“HTML → PDF → 邮件附件”的自动化闭环，大幅提升业务文档交付效率与用户体验。
