發行版
純 PHP → 核心。 Framework 應用程式 → 對應的整合套件。 網路邊界 → 伺服器。 Python 用戶端 → Python SDK。
選擇你的入門路徑
快速總覽
標題為「快速總覽」的區段NextPDF 提供多種入門方式。哪一種最適合，取決於你的程式碼在哪裡執行，以及你需要哪一種輸出。本頁會協助你做出三個選擇：要安裝哪個發行版、要使用哪套 HTML renderer，以及哪些工作負載需要 Pro 或 Enterprise 方案。
直接閱讀能回答你問題的章節，或快速瀏覽結尾的決策摘要。
選擇發行版
標題為「選擇發行版」的區段先看你的應用程式如何呼叫這個引擎。第一個符合你情境的列，就是你的答案。
| 你的情境 | 安裝 | 原因 |
|---|---|---|
| 純 PHP 專案、函式庫或 CLI 工具 | NextPDF 核心（nextpdf/core） | 只有引擎本身。它不對任何 Framework（框架）做假設，也不執行任何服務。 |
| Laravel、Symfony 或 CodeIgniter 應用程式 | 對應的 Framework 整合套件 | 你會在核心之上取得容器繫結、回應輔助方法，以及佇列工作。 |
| 必須透過網路呼叫引擎的非 PHP 服務、AI Agent（代理）或其他執行環境 | NextPDF 伺服器（nextpdf/server） | 由單一服務透過 MCP、REST 與 gRPC 對外提供這個引擎。 |
| 需要從 NextPDF 伺服器取得 PDF 的 Python 程式碼 | Python SDK 用戶端（pip install nextpdf） | 供執行中伺服器使用的具型別用戶端。它並不內嵌引擎。 |
有兩點常造成混淆：
- Framework 整合套件已內含核心。你不需要分別安裝兩者。轉接器會替你宣告並 resolve（解析）
nextpdf/core。 - Python SDK 是用戶端，不是引擎。它需要一個 NextPDF 伺服器 endpoint（端點）才能通訊。PDF 的產生是在伺服器端的 PHP 中完成。
選擇 HTML renderer
標題為「選擇 HTML renderer」的區段NextPDF 提供四種把 HTML 算繪成 PDF 的方式。內建管線不需要額外設定，就能涵蓋大多數文件。其他三個 renderer 套件，則是為需要瀏覽器等級版面，或想沿用既有服務的情境準備。
| renderer（渲染器） | 套件 | 在哪裡執行 | 何時選它 |
|---|---|---|---|
內建 writeHtml() | nextpdf/core | 行程內、純 PHP | 你需要的 HTML 與 CSS 只用到支援的子集，而且不需要瀏覽器、不需網路呼叫。 |
| Artisan | nextpdf/artisan | 主機上的 headless Chrome | 你需要完整的 Chrome 版面，包括 flexbox、grid、複雜選擇器、網頁字型，而且文字可選取。 |
| Cloudflare | nextpdf/cloudflare | 在邊緣端的 Cloudflare Browser Rendering | 算繪應該在邊緣端進行，或你不想在自己的主機上跑瀏覽器行程。 |
| Gotenberg | nextpdf/gotenberg | 由你自行運作的 Gotenberg 服務 | 你要透過既有的 Gotenberg 部署來轉換 Office 文件（DOCX、XLSX）或 HTML。 |
這張表怎麼讀：
- 請優先採用內建管線。它是最快的路徑，而且沒有外部相依。在你倚賴某個屬性之前，先對照 CSS 支援對照表確認支援狀態。
- 當版面超出支援的子集，而且算繪應留在你自己的基礎設施上時，改用 Artisan。它會啟動一個 Chrome 行程，所以要替這段生命週期做好規劃。
- 當你想要同樣的瀏覽器保真度，但偏好在邊緣端算繪，而不是在本機跑瀏覽器時，改用 Cloudflare。
- 需要轉換 Office 文件時，改用 Gotenberg；或當你已經在運作 Gotenberg，並想讓 NextPDF 來驅動它時。
何時需要 Pro 或 Enterprise
標題為「何時需要 Pro 或 Enterprise」的區段核心引擎能產生、算繪並檢視 PDF，免費且不需要授權。NextPDF Pro 與 NextPDF Enterprise 是 nextpdf/premium 套件的兩種授權方案。安裝該套件會增加功能，而且不會改動任何核心 API。
| 你需要 | 方案 | 功能 |
|---|---|---|
| 數位簽署 PDF（PAdES baseline） | Pro（專業版） | 以軟體金鑰簽署的具體實作。 |
| 產生封存用的 PDF/A 輸出 | 專業版 | PDF/A 一致性與封存設定檔。 |
| 內嵌電子發票（Factur-X/ZUGFeRD） | 專業版 | 電子發票合約的具體實作。 |
| 以硬體安全模組（HSM）簽署 | Enterprise（企業版） | 由硬體支援的金鑰操作。 |
| 簽發合格電子簽章 | 企業版 | 合格簽章工作流程與完整的合規面。 |
以下兩條規則可讓這個決策保持務實：
- 如果你的輸出是未簽署、非封存的 PDF，核心就已足夠。你不需要授權。
- 當你安裝
nextpdf/premium後，Framework 整合套件與伺服器會自動偵測到它。它們會透過同一組容器鍵與工具型錄，對外提供這些額外功能。你的應用程式不需要任何程式碼變更即可採用這些功能。
決策摘要
標題為「決策摘要」的區段HTML renderer
支援的子集、無相依 → writeHtml()。 在你自己主機上要瀏覽器保真度 → Artisan。 在邊緣端 →
Cloudflare。 Office 轉換 → Gotenberg。
授權方案
未簽署的 PDF → 核心。 簽署、PDF/A、電子發票 → Pro。 HSM 或合格簽章 → Enterprise。
還不確定嗎？
先安裝 核心，跑一遍 你的第一份 PDF，等到出現具體需求時，再加裝套件。 這些之後都可以再改。
另請參閱
標題為「另請參閱」的區段 安裝 NextPDF 每個發行版與 renderer 的確切安裝指令。
你的第一份 PDF 用 PHP 產生 PDF，並把 HTML 算繪成 PDF。
整合 完整的擴充對照表、選擇指南，以及各套件的操作手冊。
連線（伺服器） 把引擎以網路服務形式，透過 MCP、REST 與 gRPC 對外運作。