告别丑陋的PDF：Web内容转PDF的那些痛点
想象一下，你正在开发一个电子商务平台，用户下单后需要生成一份精美的订单pdf；或者你正在构建一个企业内部管理系统，需要将复杂的报表页面导出为pdf供打印或归档。你可能尝试过各种php库，比如fpdf、tcpdf，它们确实能生成pdf，但当你的html页面包含复杂的css样式、图片、表格甚至响应式布局时，这些库往往会让你抓狂。渲染效果差、样式丢失、排版错乱，甚至需要你手动将html转换为pdf友好的格式，这无疑增加了大量的工作量和维护成本。
这些问题归根结底在于，纯PHP实现的PDF库在解析和渲染现代web标准（html5、css3）方面存在局限性。我们需要一个能够像浏览器一样理解和渲染HTML/CSS的工具，并将渲染结果输出为PDF。
救星驾到：pontedilana/php-weasyprint 登场！
幸运的是，PHP生态系统并不缺乏解决方案。今天，我们要介绍的英雄是 pontedilana/php-weasyprint。这个库并非自己实现了HTML到PDF的转换逻辑，而是巧妙地充当了著名python库 WeasyPrint 的PHP“翻译官”或“操作员”。
WeasyPrint 是一个功能强大的开源工具，它能够将HTML和CSS文档转换为高质量的PDF或PNG文件。它的最大亮点在于对Web标准的高度兼容性，这意味着你用HTML和CSS设计出来的页面，几乎可以原汁原味地呈现在PDF中，包括复杂的布局、字体、颜色、图片甚至是SVG！
而 pontedilana/php-weasyprint 就是一个PHP封装器，让你可以在PHP项目中轻松调用WeasyPrint的功能，而无需直接与Python命令行交互。
立即学习“PHP免费学习笔记（深入）”；
如何将它引入你的项目？Composer 一键搞定！
首先，确保你的系统已经安装了WeasyPrint（推荐版本56或更高）。你可以通过pip安装：pip install weasyprint。
接下来，通过Composer将 pontedilana/php-weasyprint 引入你的PHP项目：
composer require pontedilana/php-weasyprint
就这么简单！Composer 会自动处理依赖关系，并将库下载到你的 vendor 目录。
实践出真知：PDF 生成实战
安装完成后，我们就可以开始使用它了。
1. 初始化 WeasyPrint 实例
你需要指定WeasyPrint可执行文件的路径。
<?php require __DIR__ . '/vendor/autoload.php'; use PontedilanaPhpWeasyPrintPdf; // 假设 WeasyPrint 在 /usr/local/bin/weasyprint $pdf = new Pdf('/usr/local/bin/weasyprint'); // 或者，你也可以先实例化，再设置路径 // $pdf = new Pdf(); // $pdf->setBinary('/usr/local/bin/weasyprint');
2. 在浏览器中直接显示 PDF
如果你想让用户点击链接后直接在浏览器中预览PDF，可以这样做：
$pdf = new Pdf('/usr/local/bin/weasyprint'); // 确保路径正确 header('Content-Type: application/pdf'); // 从一个URL生成PDF并输出 echo $pdf->getOutput('https://www.github.com');
3. 强制下载 PDF 文件
如果你希望用户点击后直接下载PDF文件，只需修改HTTP头信息：
$pdf = new Pdf('/usr/local/bin/weasyprint'); // 确保路径正确 header('Content-Type: application/pdf'); header('Content-Disposition: attachment; filename="my_document.pdf"'); // 指定下载文件名 // 从HTML字符串生成PDF并输出 echo $pdf->getOutput('<h1>欢迎来到我的报告</h1><p>这是一份重要的文档。</p>');
4. 生成本地 PDF 文件
将PDF保存到服务器的某个路径，这是最常见的应用场景之一：
$pdf = new Pdf('/usr/local/bin/weasyprint'); // 确保路径正确 $htmlContent = '<h1>账单详情</h1><p>您欠我钱，老铁。</p><p>金额：$100.00</p>'; $outputPath = '/tmp/bill-123.pdf'; // 指定保存路径 $pdf->generateFromHtml($htmlContent, $outputPath); echo "PDF文件已成功生成到: " . $outputPath;
5. 传递 WeasyPrint 选项
WeasyPrint 提供了丰富的命令行选项来控制PDF的生成，比如编码、媒体类型、图片优化等。php-weasyprint 也支持你通过 setOption 方法传递这些参数：
$pdf = new Pdf('/usr/local/bin/weasyprint'); $pdf->setOption('encoding', 'utf8'); $pdf->setOption('media-type', 'print'); // 模拟打印样式 $pdf->setOption('optimize-images', true); // 优化图片大小 $pdf->setOption('stylesheet', ['/path/to/my-custom-print.css']); // 应用自定义CSS $pdf->setOption('presentational-hints', true); // 启用HTML中的表现层提示 // ... 然后再调用 generateFromHtml 或 getOutput $pdf->generateFromHtml('<h1>我的报告</h1><p>内容...</p>', '/tmp/report.pdf');
总结：pontedilana/php-weasyprint 的核心优势
- 高保真渲染： 借助 WeasyPrint，它能够完美渲染复杂的HTML、CSS3（包括Flexbox、Grid布局、自定义字体等），让生成的PDF与你在浏览器中看到的页面几乎一模一样，告别排版错乱的烦恼。
- 易于集成： 作为Composer包，安装和使用都非常简单，几行代码就能搞定PDF生成，大大提升开发效率。
- 灵活的输入源： 无论是URL还是动态生成的HTML字符串，它都能轻松处理。
- 丰富的配置选项： 支持传递WeasyPrint的各种命令行参数，让你对PDF的生成过程拥有细致的控制权，满足各种定制化需求。
- 跨平台： 只要你的服务器环境支持Python和WeasyPrint，无论linux、macos还是windows，都能正常运行。
通过 pontedilana/php-weasyprint，我们成功地解决了PHP项目中生成高质量、高保真PDF的难题。它让PDF生成不再是令人头疼的挑战，而是成为Web应用中一个流畅、高效的功能。如果你还在为PDF渲染效果不佳而烦恼，不妨给 pontedilana/php-weasyprint 一个机会，它一定会给你带来惊喜！
