使用mPDF生成PDF文件并通过邮件发送的完整实现方案

使用mPDF生成PDF文件并通过邮件发送的完整实现方案

前言

在实际业务场景中，我们经常需要将动态生成的PDF文件通过电子邮件发送给用户。mPDF作为一款强大的PHP PDF生成库，结合邮件发送功能可以实现这一需求。本文将详细介绍如何使用mPDF创建PDF文件并通过邮件发送的完整技术方案。

环境准备

首先确保你的PHP环境已经安装以下组件：

• PHP 5.6或更高版本
• Composer包管理工具
• 必要的PHP扩展（mbstring、gd等）

创建PDF文件

1. 初始化mPDF实例

require __DIR__ . '/vendor/autoload.php';
$mpdf = new \Mpdf\Mpdf();

2. 生成PDF内容

我们使用输出缓冲技术来捕获HTML内容：

ob_start(); // 开启输出缓冲

$day = date('d');
$year = date('Y');
$month = date('F');

echo "Hello World

Today is $month $day, $year";

$html = ob_get_contents(); // 获取缓冲区内容
ob_end_clean(); // 清空并关闭缓冲区

3. 写入PDF并获取内容

$mpdf->WriteHTML(utf8_encode($html)); // 确保UTF-8编码
$content = $mpdf->Output('', 'S'); // 'S'参数表示以字符串形式返回PDF内容

邮件发送实现

直接构建邮件附件会遇到许多技术难题，如MIME类型处理、编码问题等。推荐使用成熟的邮件库Swift Mailer来处理。

1. 安装Swift Mailer

通过Composer安装：

composer require swiftmailer/swiftmailer

2. 创建邮件附件

$attachment = new Swift_Attachment(
    $content,        // PDF内容
    'filename.pdf',  // 附件文件名
    'application/pdf' // MIME类型
);

3. 构建邮件消息

$message = Swift_Message::newInstance()
    ->setSubject('您的PDF文件')  // 邮件主题
    ->setFrom(['sender@example.com' => '发件人名称']) // 发件人
    ->setTo(['recipient@example.com' => '收件人名称']) // 收件人
    ->setBody('请查收附件中的PDF文件') // 邮件正文
    ->attach($attachment); // 添加附件

4. 配置邮件传输并发送

$transport = Swift_MailTransport::newInstance();
$mailer = Swift_Mailer::newInstance($transport);
$result = $mailer->send($message);

高级配置选项

1. 使用SMTP发送

对于生产环境，建议使用SMTP而非mail()函数：

$transport = Swift_SmtpTransport::newInstance('smtp.example.com', 25)
    ->setUsername('your_username')
    ->setPassword('your_password');

2. 添加HTML邮件正文

$message->setBody('<p>请查收附件中的PDF文件</p>', 'text/html')
    ->addPart('请查收附件中的PDF文件', 'text/plain');

3. 处理发送结果

if ($result) {
    echo "邮件发送成功";
} else {
    echo "邮件发送失败";
}

常见问题解决方案

1. 编码问题：确保所有文本内容使用UTF-8编码
2. 附件大小限制：大文件可能需要调整PHP内存限制
3. 垃圾邮件过滤：设置合适的发件人地址和邮件内容
4. 性能优化：对于批量发送，考虑使用队列处理

总结

本文详细介绍了使用mPDF生成PDF文件并通过Swift Mailer发送邮件的完整流程。这种方案结合了两个优秀库的优势，mPDF负责PDF生成，Swift Mailer处理复杂的邮件发送逻辑，为开发者提供了稳定可靠的解决方案。在实际项目中，你可以根据需求进一步扩展和优化这个基础实现。