如何使用 DOMPDF 生成 HTML 并以 PDF 附件形式发送邮件-php教程-PHP中文网

如何使用 DOMPDF 生成 HTML 并以 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 二进制流，并持久化为临时文件或内存附件。

✅ 核心步骤解析

渲染 PDF 并获取二进制内容：使用 $dompdf->output()（而非 stream()），返回完整的 PDF 字节流；
暂存 PDF 文件（推荐）：使用 file_put_contents() 保存为本地临时文件（如 invoice_20241125.pdf），便于 PHPMailer 加载；
集成 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 并记录日志。