最近在开发一个Symfony项目时，我们遇到了一个“老大难”的问题：需要根据用户提供的数据，动态生成包含图表和复杂布局的PDF报表。一开始，我们尝试了一些纯PHP的PDF生成库，但很快就发现它们在处理复杂的HTML和CSS样式时力不从心，生成的PDF要么排版混乱，要么样式丢失，完全达不到我们对视觉效果的要求。更糟糕的是，如果想保持Web页面和PDF输出的一致性，几乎要写两套不同的样式代码，这简直是噩梦。

我们还考虑过直接调用一些命令行工具，比如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非常简单：

composer require pontedilana/weasyprint-bundle

安装完成后，如果你使用的是Symfony Flex，它通常会自动帮你启用Bundle。如果没有，你需要在config/bundles.php中手动添加：

// config/bundles.php
 ['all' => true],
    //...
];

接下来是配置。这个Bundle允许你自定义WeasyPrint二进制文件的路径、临时文件夹，甚至设置进程超时时间。例如，在config/packages/weasyprint.yaml中：

# 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控制器中直接注入并使用它。

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

   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：

   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类会派上大用场：

   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：

   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，它绝对会是你的得力助手！