最近在开发一个symfony项目时，我们遇到了一个“老大难”的问题：需要根据用户提供的数据，动态生成包含图表和复杂布局的pdf报表。一开始，我们尝试了一些纯php的PDF生成库，但很快就发现它们在处理复杂的html和css样式时力不从心，生成的PDF要么排版混乱，要么样式丢失，完全达不到我们对视觉效果的要求。更糟糕的是，如果想保持Web页面和PDF输出的一致性，几乎要写两套不同的样式代码，这简直是噩梦。
我们还考虑过直接调用一些命令行工具，比如wkhtmltopdf，但这意味着要手动安装和配置这些外部依赖，处理不同服务器环境下的兼容性问题，还要在PHP代码中拼接复杂的命令行参数，维护起来非常麻烦，而且容易出错。团队成员对此都感到非常头疼，开发进度也因此受阻。
就在我们一筹莫展之际，我偶然发现了pontedilana/weasyprint-bundle这个Composer包。它基于WeasyPrint，一个强大的python库，能够将HTML和CSS完美地转换为PDF。更棒的是，这个Bundle为Symfony项目提供了无缝集成，简直是为我们量身定制的“救星”！
WeasyPrint是什么？ 简单来说，WeasyPrint是一个功能强大、开源的Python工具，它能够将任何HTML文档（包括内联的CSS和javaScript）转换成高质量的PDF文件。它的优势在于对Web标准（尤其是CSS）的支持非常出色，因此生成的PDF能够高度还原HTML页面的布局和样式，这对于我们这种需要保持视觉一致性的报表来说至关重要。
如何使用Composer和pontedilana/weasyprint-bundle解决问题？
首先，使用Composer安装这个Bundle非常简单：
<code class="bash">composer require pontedilana/weasyprint-bundle</code>
安装完成后，如果你使用的是Symfony flex，它通常会自动帮你启用Bundle。如果没有，你需要在config/bundles.php中手动添加：
<pre class="brush:php;toolbar:false;">// config/bundles.php <?php return [ //... PontedilanaWeasyprintBundleWeasyprintBundle::class => ['all' => true], //... ];
接下来是配置。这个Bundle允许你自定义WeasyPrint二进制文件的路径、临时文件夹，甚至设置进程超时时间。例如，在config/packages/weasyprint.yaml中：
<pre class="brush:php;toolbar:false;"># config/packages/weasyprint.yaml weasyprint: pdf: enabled: true binary: /usr/local/bin/weasyprint # 确保你的服务器上安装了WeasyPrint并配置了正确的路径 options: [] temporary_folder: "%kernel.cache_dir%/weasyprint" # 自定义临时文件夹 process_timeout: 60 # 进程超时时间，单位秒
注意： 使用这个Bundle前，你需要在你的服务器上安装WeasyPrint。通常可以通过pip安装：pip install weasyprint。
实际应用：生成PDF文档
pontedilana/weasyprint-bundle注册了一个名为weasyprint.pdf的服务，你可以在Symfony控制器中直接注入并使用它。
-
从URL生成PDF： 如果你想将一个已有的网页转换为PDF，这非常方便：
<pre class="brush:php;toolbar:false;">use PontedilanaPhpWeasyPrintPdf; // ... public function generateFromUrl(Pdf $weasyprintPdf) { $weasyprintPdf->generate('https://www.example.com', '/path/to/save/output.pdf'); // ... } -
从Twig模板生成PDF： 这正是我们最需要的功能！我们可以像渲染普通HTML页面一样渲染Twig模板，然后将渲染后的HTML内容传递给WeasyPrint：
<pre class="brush:php;toolbar:false;">use PontedilanaPhpWeasyPrintPdf; use SymfonyBundleFrameworkBundleControllerAbstractController; // ... class ReportController extends AbstractController { public function generateReportPdf(Pdf $weasyprintPdf) { $html = $this->renderView( 'reports/monthly_report.html.twig', [ 'reportData' => ['item1' => 'Value A', 'item2' => 'Value B'], 'title' => '月度销售报告', ] ); $weasyprintPdf->generateFromHtml($html, '/path/to/save/monthly_report.pdf'); return $this->json(['message' => 'PDF report generated successfully!']); } } -
直接作为HTTP响应返回PDF： 如果用户点击一个链接就直接下载PDF，
PdfResponse类会派上大用场：<pre class="brush:php;toolbar:false;">use PontedilanaWeasyprintBundleWeasyPrintResponsePdfResponse; use PontedilanaPhpWeasyPrintPdf; use SymfonyBundleFrameworkBundleControllerAbstractController; class ProductController extends AbstractController { public function downloadProductSheet(Pdf $weasyprintPdf) { $html = $this->renderView( 'frontend/product/pdf_sheet.html.twig', [ 'product' => ['name' => 'Awesome Gadget', 'price' => 99.99], ] ); return new PdfResponse( $weasyprintPdf->getOutputFromHtml($html), // 获取PDF的二进制内容 'product_sheet.pdf' // 下载时的文件名 ); } }小技巧： 如果你的Twig模板中包含相对路径的CSS或图片，为了让WeasyPrint正确加载它们，最好使用绝对URL来渲染HTML，或者在
getOutput方法中直接传入页面的绝对URL：<pre class="brush:php;toolbar:false;">public function downloadProductSheetWithRelativeAssets(Pdf $weasyprintPdf) { $pageUrl = $this->generateUrl('product_detail_page', ['id' => 123], true); // 生成绝对URL return new PdfResponse( $weasyprintPdf->getOutput($pageUrl), 'product_sheet_from_url.pdf' ); }
总结与优势
通过pontedilana/weasyprint-bundle，我们彻底解决了在Symfony项目中生成高质量PDF的难题。它的优势显而易见：
- 高质量渲染： WeasyPrint对HTML和CSS标准的支持非常优秀，确保生成的PDF与Web页面视觉效果高度一致，告别排版错乱的烦恼。
- 无缝集成Symfony： 作为Composer包和Symfony Bundle，它完美融入了Symfony的生态系统，通过服务注入即可轻松使用，无需复杂的配置和手动管理外部进程。
- 开发效率提升： 开发者可以直接利用熟悉的Twig模板来设计PDF内容，大大减少了学习成本和开发时间。一份模板，多处使用（Web和PDF），维护也更简单。
- 灵活性： 支持从HTML字符串、Twig模板或URL生成PDF，并可直接作为HTTP响应返回，满足各种应用场景。
- Composer管理： 依赖管理和版本控制都通过Composer完成，保持项目的整洁和可维护性。
现在，我们的PDF报表不仅美观专业，而且生成过程也变得前所未有的简单和高效。如果你也在为PHP项目中的PDF生成问题而苦恼，强烈推荐你尝试pontedilana/weasyprint-bundle，它绝对会是你的得力助手！
以上就是在Symfony中如何高效生成高质量PDF报表？使用pontedilana/weasyprint-bundle轻松搞定的详细内容，更多请关注