跳到內容

Cookbook(範例指南)

本 Cookbook 以任務為導向。每則範例都提供一個可直接複製且有原始碼佐證的範本,用來解決單一問題。這些範例依執行位置分為三大類。請先依你呼叫 NextPDF 的方式選出對應類別,再從中挑選範例。

如果你想了解引擎為什麼會呈現特定行為,請參閱 Guides(指南)。如果你需要經過驗證的 API 介面,請參閱 Reference(參考文件)。

PHP 範例會在行程內直接使用核心引擎。每則範例都從執行 composer require nextpdf/core 安裝開始,接著透過公開 API 建構、簽署、檢視或轉換文件,例如 Document::createStandalone()writeHtml()

Connect 範例會透過伺服器工具註冊表,以 Model Context Protocol(MCP)、Representational State Transfer(REST)或 gRPC 呼叫 NextPDF。同一個工具呼叫在這三種 transport 上的行為一致,且都受到人在迴路中的確認閘門(gate)保護。

整合範例會把 NextPDF 接入某個應用程式 framework,或把算繪工作委派給外部 backend。內容涵蓋各 framework 轉接器與 renderer 橋接器,以及從舊有函式庫遷移而來的路徑。

每則範例都遵循一份明確契約:有原始碼佐證的範本、可重現性設定檔的 front-matter、誠實標示的符合性邊界,以及發布閘門。改寫任何範本之前,請先閱讀你所用類別對應的慣例頁。

  • Guides — 概念與操作說明文件索引。
  • Reference — 經過驗證的 API 介面與 CSS 支援對照表。
  • 選擇一種整合方式 — 將使用情境對映至整合方式的決策表。