Cookbook(範例指南)
快速概覽
標題為「快速概覽」的區段本 Cookbook 以任務為導向。每則範例都提供一個可直接複製且有原始碼佐證的範本,用來解決單一問題。這些範例依執行位置分為三大類。請先依你呼叫 NextPDF 的方式選出對應類別,再從中挑選範例。
如果你想了解引擎為什麼會呈現特定行為,請參閱 Guides(指南)。如果你需要經過驗證的 API 介面,請參閱 Reference(參考文件)。
PHP 範例
標題為「PHP 範例」的區段PHP 範例會在行程內直接使用核心引擎。每則範例都從執行 composer require nextpdf/core 安裝開始,接著透過公開 API 建構、簽署、檢視或轉換文件,例如 Document::createStandalone() 與 writeHtml()。
PHP 範例 每則 PHP 原生範例的 Index(索引):把 HTML 算繪成 PDF、排版表格、嵌入與子集化字型、以 AES-256 加密、以 PAdES 簽署、輸出 PDF/A-4 與標記化的 PDF/UA-2、擷取文字,以及檢視既有檔案。
Connect 範例
標題為「Connect 範例」的區段Connect 範例會透過伺服器工具註冊表,以 Model Context Protocol(MCP)、Representational State Transfer(REST)或 gRPC 呼叫 NextPDF。同一個工具呼叫在這三種 transport 上的行為一致,且都受到人在迴路中的確認閘門(gate)保護。
Connect 範例 供 NextPDF Connect 伺服器使用、與 transport 無關的範例:hello world、HTML 表格、影像嵌入、數位簽章、無障礙與合規檢查、遮蔽(redaction)、鑑識分析,以及以 OpenTelemetry 做的可觀測性。
整合範例
標題為「整合範例」的區段整合範例會把 NextPDF 接入某個應用程式 framework,或把算繪工作委派給外部 backend。內容涵蓋各 framework 轉接器與 renderer 橋接器,以及從舊有函式庫遷移而來的路徑。
整合範例 生態系套件的範例:選擇一種整合方式、從 framework 控制器回傳 PDF、在背景工作中排入產生作業、以 Artisan 算繪 HTML、以 Gotenberg 轉換 Office 檔案、以 Cloudflare 在邊緣算繪,以及依循 TCPDF 遷移路徑。
範例慣例
標題為「範例慣例」的區段每則範例都遵循一份明確契約:有原始碼佐證的範本、可重現性設定檔的 front-matter、誠實標示的符合性邊界,以及發布閘門。改寫任何範本之前,請先閱讀你所用類別對應的慣例頁。
整合範例慣例 每則可執行的整合範例都遵循的契約:有原始碼佐證的範本、可重現性設定檔的 front-matter,以及發布閘門。
Connect 範例慣例 每則 Connect 範例都遵循的契約:與 transport 無關的工具呼叫、依方案層級而定的工具、風險模型與確認閘門,以及誠實標示的符合性邊界。