Gotenberg 整合

概覽

當你需要把轉換工作委派給 Gotenberg 服務時，請使用 nextpdf/gotenberg；它特別適合處理 office 文件，以及應在 PHP 程序之外執行的 HTML 轉 PDF 流程。

章節地圖

頁面	適用情境
概覽	套件邊界與支援的工作流程。
安裝	Composer 安裝與 Gotenberg 服務的先決條件。
快速上手	第一次執行轉換的流程。
組態設定	endpoint、逾時與安全性相關的組態鍵。
API	橋接器、組態、payload、結果、parser、office 格式與釘選版傳輸的 API。
開發者指南	服務邊界、payload 建構與擴充點。
正式環境使用	部署與維運模式。
安全性與維運	SSRF 控管、MIME 處理、大小限制，以及釘選版傳輸。
疑難排解	常見的轉換與服務失敗。

主要 API

符號	角色
NextPDF\Gotenberg\GotenbergBridge	透過 Gotenberg 服務轉換輸入內容。
NextPDF\Gotenberg\GotenbergConfig	不可變的服務組態物件。
NextPDF\Gotenberg\GotenbergConvertPayload	轉換請求的 payload。
NextPDF\Gotenberg\GotenbergConvertResult	轉換後的 PDF 位元組與回應中繼資料。
NextPDF\Gotenberg\OfficeFormat	支援的 office 文件格式列舉（enum）。