PHP 將 HTML 轉 PDF 的開源庫深度評測：DomPDF、TCPDF、wkhtmltopdf、FPDF 選型指南

背景

早期僅有 FPDF 純 PHP 繪圖，開發成本極高。現代項目多採用「HTML + CSS → PDF」流程，本文對比四大主流方案特性、性能、CSS 支持度、維護現狀，助你選型。

對比總覽

深度剖析

1. DomPDF —— 最接近瀏覽器的純 PHP 方案

• 安裝：composer require dompdf/dompdf
• 特性：支援外部 CSS、@page 分頁控制、表格跨頁、圖片 (Base64/URL)、字體嵌入 (TTF/OTF)。
• 局限：Flexbox/Grid 不支援、大文檔 (50 頁+) 記憶體飆升、JS 不執行。
• 代碼：

  use Dompdf\Dompdf;
  $dompdf = new Dompdf();
  $dompdf->loadHtml($html);
  $dompdf->setPaper('A4', 'portrait');
  $dompdf->render();
  $dompdf->stream('report.pdf', ['Attachment' => false]);

2. TCPDF —— 功能最全的瑞士軍刀

• 特性：內建條碼 (QR/1D/2D)、數字簽名、RTL 語言、PDF/A、PDF/UA、表單字段、書籤、水印、匯入現有 PDF 模板。
• HTML 支持弱：僅簡易標籤，複雜排版需用原生 API (Cell(), MultiCell(), writeHTML()) 混合。
• 適合：需合規歸檔 (PDF/A)、簽章、條碼、複雜表單的企業級應用。

3. wkhtmltopdf —— 真·瀏覽器級渲染

• 原理：打包 QtWebKit (舊) 或 Chromium (新 fork: wkhtmltopdf / finaldraft/wkhtmltopdf) 執行無頭渲染。
• PHP 封裝：composer require mikehaertl/phpwkhtmltopdf 或 knplabs/knp-snappy (Symfony/Laravel 常用)。
• 優勢：完美支持現代 CSS (Flex/Grid/動畫)、JS 執行 (延遲加載圖表)、打印媒體查詢、頁眉頁腳模板。
• 部署：需服務器安裝二進制文件 (Linux 靜態編譯版 ~40MB)，Docker 部署極簡。
• 代碼：

  use Knp\Snappy\Pdf;
  $snappy = new Pdf('/usr/local/bin/wkhtmltopdf');
  $snappy->generateFromHtml($html, 'report.pdf', [
      'page-size' => 'A4',
      'margin-top' => '10mm',
      'javascript-delay' => 2000, // 等待 JS 渲染
  ]);

4. FPDF —— 輕量繪圖核心

• 無依賴、單文件、極快、記憶體極低。
• 適用：生成標籤、簡單表格、條碼 (配合 fpdf17/script/barcode.php)、固定版式證書。
• 擴展庫：tFPDF (Unicode/TTF)、FPDI (匯入現有 PDF)。

選型決策樹

1. 需完美還原網頁樣式、含圖表/JS → wkhtmltopdf (或新頭 headless-chrome-php/browsershot)。
2. 純 PHP 環境、無法安裝二進制、文檔 < 20 頁 → DomPDF。 3. 需 PDF/A 歸檔、數字簽名、條碼、複雜表單 → TCPDF。 4. 極簡表格/標籤、追求零依賴高性能 → FPDF / tFPDF。

補充：新一代方案

• Browsershot (Spatie) / Chrome-PHP/Headless-Chrome：駕駭真 Chrome Headless，渲染完美、支援現代 Web 技術，適合雲原生部署 (需 Puppeteer/Chromium)。
• WeasyPrint (Python) + API 服務化：CSS Paged Media 標準支持最好。