指南
本節彙整 NextPDF 的概念與操作文件;NextPDF 是一套 headless PHP 8.4 可攜式文件格式 2.0(PDF 2.0)引擎。下方每張卡片都指向一個章節中樞,而非單一頁面。請用它找到正確的起點,再依該中樞內的連結繼續深入。
指南回答的是怎麼做與為什麼。若你需要任務導向、可直接複製的 recipe(範例),請前往 Cookbook(範例指南)。若你需要已驗證的 API 介面與支援矩陣,請前往 Reference。
整合指南
標題為「整合指南」的區段NextPDF 擴充套件會將核心引擎連接到應用程式框架、瀏覽器 renderer(渲染器)、邊緣服務、建構工具,以及舊系統移轉流程。每個擴充套件章節都遵循相同的手冊結構:概觀、安裝、快速上手、組態、API、開發者指南、生產環境使用、安全性,以及疑難排解。
整合套件 框架轉接器(Laravel、Symfony、CodeIgniter)、渲染器橋接器(Artisan、Cloudflare、Gotenberg)、TCPDF 相容 shim(相容層),以及 Backport Builder。請先閱讀擴充套件地圖與選用指南。
移轉 把現有的程式碼庫移轉到 NextPDF。提供 dompdf 與 mPDF 的個別來源指南,外加每份指南共通的一條原則:行為相容,而非位元組層級輸出完全相同,差異皆有文件記載。
伺服器與 SDK
標題為「伺服器與 SDK」的區段若你的呼叫端位於遠端、是以另一種語言撰寫,或是需要工具 endpoint(而非 PHP 函式庫)的人工智慧(AI)系統,請使用這些指南。
NextPDF Connect(伺服器) nextpdf/server 套件:一個確定性的 PDF 工具登錄表,透過 Model Context Protocol(MCP)、具象狀態傳輸(REST)與 gRPC 提供服務,並置於人為介入(human-in-the-loop)確認 gate 之後。可安裝、組態與部署。
Python SDK 為 Python 應用程式、代理與命令列提供可供引用的 PDF 擷取功能,背後由 NextPDF Connect endpoint 支援。以 pip install nextpdf 安裝,再讓用戶端指向你的伺服器。
標準與符合性
標題為「標準與符合性」的區段NextPDF Core 以各項標準要求的結構為目標。符合性本身則由外部驗證器、檢查器或接收方權責機關判定。每個符合性頁面都會把主張追溯回某個條款,並清楚維持這條界線。
符合性 NextPDF 所對應的標準設定檔:PDF 2.0(ISO 32000-2)、PDF/A-4(ISO 19005-4)封存、PDF/UA-2(ISO 14289-2)無障礙、PDF/X 印刷製作,以及 ZUGFeRD / Factur-X 電子發票。
PAdES 基準對應 NextPDF 如何對應到 ETSI EN 319 142 的 PAdES 基準層級 B-B、B-T、B-LT 與 B-LTA,並把 Core 的簽章介面與 Premium 及 Enterprise 層級區分開來。
維運與擴充
標題為「維運與擴充」的區段這些指南涵蓋如何在生產環境中安全執行 NextPDF、診斷失敗,以及在公開的擴充介面上進行開發。
信任與安全性 核心引擎的工程姿態:威脅模型、簽章與加密的安全模型、資料處理行為,以及漏洞揭露政策,並標明各自的界線。
疑難排解 針對簽章、PDF/A、PDF/UA、字型、標記、加密與權限失敗,提供由症狀到解法的條目,並以引擎本身的例外分類為依據。
擴充套件開發 公開的服務提供者介面(SPI):你能擴充什麼、其背後的穩定性承諾、自訂字型、自訂排版引擎、動作觸發器,以及金鑰管理服務(KMS)供應者契約。
Premium(Pro 與 Enterprise) NextPDF Pro 與 Enterprise 在開放原始碼核心之上額外加入的功能:能力矩陣、標準符合性、HSM 與 FIPS 驗證,以及授權。採用商業版本不需要變更任何應用程式程式碼。
Insider_ 章節說明 NextPDF 為什麼會這樣運作。它以資深工程師的視角呈現整體設計,並依背後的證據種類標記每一項主張。
概念(Insider_) 設計理念、標準全貌、HTML 管線、簽章與長期驗證、字型、大量生成,以及測試方法。從這裡開始理解引擎的推理脈絡。