開始使用 NextPDF

概覽

NextPDF 是一套 PHP 8.4 引擎，用來產生並檢查 PDF 2.0 文件，也就是 ISO 32000-2 所定義的檔案格式。你可以用強型別、流暢的 API 建構文件，將 HTML 與 CSS 繪製成頁面，為輸出加上簽章並封存，也能把結構化內容讀回來。這一切都在 PHP 中執行，核心路徑不需要任何外部執行檔。

本專案提供四種發行版本。它們底層共用同一套引擎，因此只要安裝最符合你工作方式的版本即可。

發行版本	套件	適用情境
NextPDF 核心（OSS）	`nextpdf/core`	你撰寫 PHP，想直接使用引擎；無論搭配 Framework（框架）或單獨使用都可以。
NextPDF Server 伺服器（OSS）	`nextpdf/server`	你想要一個獨立服務，透過 MCP、REST 與 gRPC 對外提供引擎。
NextPDF Pro 專業版	`nextpdf/premium`（Pro 層級）	你需要數位簽章、PDF/A 封存，或電子發票輸出。
NextPDF Enterprise 企業版	`nextpdf/premium`（Enterprise 層級）	你需要硬體支援的簽章、合格簽章，以及完整的合規支援範圍。

NextPDF Pro 與 NextPDF Enterprise 是同一個 nextpdf/premium 套件的兩個授權層級。無論該套件是否存在，核心引擎都會以相同方式運作。

一行指令完成安裝

若是單純的 PHP 專案，請用 Composer 安裝核心引擎。

composer require nextpdf/core

只需這一個套件，不用任何額外設定就能產生並檢查 PDF。Framework 整合、HTML renderer、伺服器與 Python SDK，則分別再加裝一個套件。安裝指南一節列出了每一道指令。

挑選你的路徑

NextPDF 能融入既有程式碼。請選擇符合你技術堆疊的進入點，再依照對應卡片操作。

安裝完整的安裝矩陣：核心、Framework 整合、HTML renderer、伺服器，以及 Python SDK。

你的第一份 PDF 一篇簡短教學，先用 PHP 產生 PDF，再把 HTML 繪製成 PDF。

選擇你的路徑一份決策指南：核心、Framework，還是伺服器，以及該用哪一個 HTML renderer。

整合 Framework 轉接器、瀏覽器 renderer、邊緣服務，以及遷移套件。

接下來該看哪裡

產生第一份文件之後，接下來可以閱讀這份文件的三大主要區塊。

指南與整合操作符合你 Framework、renderer、執行環境或遷移目標的套件 —— Laravel、Symfony、CodeIgniter、Artisan、Cloudflare 與 Gotenberg。

API 參考經過驗證的引擎介面：類別、方法、組態鍵，以及 CSS 支援矩陣。

Cookbook（範例指南）以任務為中心的 recipe（範例）—— 把 HTML 繪製成 PDF、用 CSS 設定樣式、排版表格，以及為長內容分頁。

為什麼要有獨立的伺服器？

安裝 NextPDF Server 的時機：當非 PHP 服務、AI Agent（代理）或其他執行環境需要透過網路協定呼叫引擎，而不是連結函式庫時。而 Python SDK 則是該伺服器的強型別用戶端。