DOMPDF生成PDF并发送邮件教程

本文手把手教你如何在 PHP 中无缝集成 DOMPDF 与 PHPMailer，将动态 HTML 内容（如发票或订单单）实时渲染为高质量 PDF，并作为附件自动发送至用户邮箱——避开 stream() 的浏览器限制，巧妙利用 output() 获取原始二进制流，配合临时文件存储与 SMTP 配置，实现“一键生成+自动投递”的完整自动化流程，代码即开即用，助你轻松搞定企业级 PDF 邮件交付需求。

本文详解如何在 PHP 中利用 DOMPDF 将 HTML 内容渲染为 PDF，并通过 PHPMailer 作为邮件附件自动发送，涵盖 PDF 生成、文件保存、邮件配置与附件添加等关键步骤。

本文详解如何在 PHP 中利用 DOMPDF 将 HTML 内容渲染为 PDF，并通过 PHPMailer 作为邮件附件自动发送，涵盖 PDF 生成、文件保存、邮件配置与附件添加等关键步骤。

在 Web 开发中，常需将动态生成的 HTML 报表（如发票、订单确认单）转换为 PDF 并自动发送至用户邮箱。DOMPDF 是一个成熟稳定的 PHP HTML-to-PDF 渲染库，但其 stream() 方法仅用于浏览器下载，无法直接用于邮件附件。要实现“HTML → PDF → 邮件附件”全流程，关键在于调用 output() 方法获取原始 PDF 二进制流，并持久化为临时文件或内存附件。

✅ 核心步骤解析

1. 渲染 PDF 并获取二进制内容：使用 $dompdf->output()（而非 stream()），返回完整的 PDF 字节流；
2. 暂存 PDF 文件（推荐）：使用 file_put_contents() 保存为本地临时文件（如 invoice_20241125.pdf），便于 PHPMailer 加载；
3. 集成 PHPMailer 发送带附件邮件：配置 SMTP 连接后，调用 addAttachment() 添加 PDF 文件路径。

? 完整可运行示例代码

<?php
require 'vendor/autoload.php'; // 确保已通过 Composer 安装 dompdf/dompdf 和 phpmailer/phpmailer

use Dompdf\Dompdf;
use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\SMTP;

// 1. 初始化 DOMPDF
$dompdf = new Dompdf([
    'defaultFont' => 'Helvetica',
    'isRemoteEnabled' => true // 启用远程资源（如 CDN 图片）
]);
$dompdf->loadHtml(html_entity_decode($output)); // $output 为你的 HTML 字符串
$dompdf->setPaper('A4', 'portrait');
$dompdf->render();

// 2. 获取 PDF 二进制内容并保存为临时文件
$pdfContent = $dompdf->output();
$filename = 'invoice_' . date('YmdHis') . '.pdf';
file_put_contents($filename, $pdfContent);

// 3. 使用 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_TLS;
    $mail->Port       = 587;

    $mail->setFrom('your_email@gmail.com', 'Your App');
    $mail->addAddress('recipient@example.com', 'Client Name');
    $mail->Subject = 'Your Invoice is Ready (PDF Attached)';
    $mail->Body    = 'Please find your invoice attached as a PDF file.';

    // ✅ 关键：添加 PDF 附件
    $mail->addAttachment($filename);

    $mail->send();
    echo "Email sent successfully with PDF attachment.";

    // （可选）发送后清理临时文件
    unlink($filename);

} catch (Exception $e) {
    error_log("Mailer Error: " . $mail->ErrorInfo);
    echo "Message could not be sent. Mailer Error: {$mail->ErrorInfo}";
}

⚠️ 注意事项与最佳实践

• 安全建议：避免硬编码敏感信息（如邮箱密码），应使用环境变量（如 $_ENV['SMTP_PASSWORD']）或配置中心管理；
• 临时文件管理：务必在邮件发送成功后调用 unlink($filename) 删除临时 PDF，防止磁盘占用累积；
• 内存优化（高级）：若服务对磁盘 I/O 敏感，可改用 addStringAttachment($pdfContent, $filename, 'base64', 'application/pdf') 直接传入二进制流，跳过文件写入；
• 字体与中文支持：DOMPDF 默认不支持中文字体，需注册自定义字体（如 Noto Sans CJK），并在 CSS 中显式声明 font-family；
• 错误处理：$dompdf->render() 可能因 HTML 结构异常（如未闭合标签、非法嵌套）抛出异常，建议包裹 try...catch 并记录日志。

✅ 总结

DOMPDF 的 output() 方法是连接 PDF 生成与邮件分发的核心桥梁。结合 PHPMailer 的灵活附件机制，即可构建稳定可靠的自动化 PDF 邮件工作流。实际部署时，请务必测试不同 HTML 复杂度下的渲染一致性，并针对生产环境调整超时、内存限制及 SMTP 重试策略。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。