在Symfony中如何高效生成高质量PDF报表？使用pontedilana/weasyprint-bundle轻松搞定

我们还考虑过直接调用一些命令行工具，比如wkhtmltopdf，但这意味着要手动安装和配置这些外部依赖，处理不同服务器环境下的兼容性问题，还要在PHP代码中拼接复杂的命令行参数，维护起来非常麻烦，而且容易出错。团队成员对此都感到非常头疼，开发进度也因此受阻。

Composer在线学习地址：学习地址

就在我们一筹莫展之际，我偶然发现了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 [
    //...
    Pontedilana\WeasyprintBundle\WeasyprintBundle::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。

SEEK.ai

AI驱动的智能数据解决方案，询问您的任何数据并立即获得答案

100

查看详情

实际应用：生成PDF文档

pontedilana/weasyprint-bundle注册了一个名为weasyprint.pdf的服务，你可以在Symfony控制器中直接注入并使用它。

1. 从URL生成PDF： 如果你想将一个已有的网页转换为PDF，这非常方便：

   <pre class="brush:php;toolbar:false;">use Pontedilana\PhpWeasyPrint\Pdf;
   // ...
   public function generateFromUrl(Pdf $weasyprintPdf)
   {
       $weasyprintPdf->generate('https://www.example.com', '/path/to/save/output.pdf');
       // ...
   }

   登录后复制

2. 从Twig模板生成PDF： 这正是我们最需要的功能！我们可以像渲染普通HTML页面一样渲染Twig模板，然后将渲染后的HTML内容传递给WeasyPrint：

   <pre class="brush:php;toolbar:false;">use Pontedilana\PhpWeasyPrint\Pdf;
   use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
   // ...
   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!']);
       }
   }

   登录后复制

3. 直接作为HTTP响应返回PDF： 如果用户点击一个链接就直接下载PDF，PdfResponse类会派上大用场：

   <pre class="brush:php;toolbar:false;">use Pontedilana\WeasyprintBundle\WeasyPrint\Response\PdfResponse;
   use Pontedilana\PhpWeasyPrint\Pdf;
   use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
   
   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轻松搞定的详细内容，更多请关注php中文网其它相关文章！