跳轉到

歡迎使用 NextPDF

NextPDF — PDF 2.0 Engine for Modern PHP — Built for Humans, Ready for AI

本節將引導你從零開始，選擇正確的套件組合，並在最短時間內將 NextPDF 整合進你的專案。

你需要什麼？

請依照以下決策流程選擇適合的入門指南：

flowchart TD
    Start(["我需要產生 PDF"]) --> Q1{"使用框架？"}

    Q1 -->|"Laravel"| Laravel["nextpdf/laravel<br/>→ 快速開始：Laravel"]
    Q1 -->|"Symfony"| Symfony["nextpdf/symfony<br/>→ 快速開始：Symfony"]
    Q1 -->|"CodeIgniter"| CI["nextpdf/codeigniter<br/>→ 快速開始：CodeIgniter"]
    Q1 -->|"無框架 / 純 PHP"| Q2{"需要商業功能？"}

    Q2 -->|"不需要<br/>（基本 PDF 生成）"| Core["nextpdf/core<br/>→ 快速開始：Core"]
    Q2 -->|"需要圖表、PAdES、PDF/A"| Pro["nextpdf/pro<br/>→ 快速開始：Pro"]
    Q2 -->|"需要 HSM、ZUGFeRD、批次"| Ent["nextpdf/enterprise<br/>→ 快速開始：Enterprise"]

    Core --> Q3{"PHP 版本？"}
    Q3 -->|"PHP 8.5"| Install["→ 安裝指南"]
    Q3 -->|"PHP 8.1 / 7.4"| Backport["nextpdf/backport<br/>→ PHP 相容性說明"]

    Laravel --> Install
    Symfony --> Install
    CI --> Install
    Pro --> Install
    Ent --> Install
    Backport --> Install

    click Install "installation.md"
    click Laravel "quickstart-laravel.md"
    click Symfony "quickstart-symfony.md"
    click CI "quickstart-codeigniter.md"
    click Core "quickstart.md"
    click Backport "php-compatibility.md"

依使用情境選擇

適用情境：發票、收據、報表、靜態文件

推薦套件：nextpdf/core

composer require nextpdf/core

入門指南：快速開始（5 分鐘）

適用情境：Laravel 應用程式、API 驅動 PDF 生成、Queue 非同步處理

推薦套件：nextpdf/laravel（自動包含 nextpdf/core）

composer require nextpdf/laravel

入門指南：Laravel 快速開始

適用情境：Symfony 應用程式、DI Container 整合、Messenger 非同步處理

推薦套件：nextpdf/symfony（自動包含 nextpdf/core）

composer require nextpdf/symfony

入門指南：Symfony 快速開始

適用情境：CodeIgniter 4 應用程式、helper 函數快速整合

推薦套件：nextpdf/codeigniter（自動包含 nextpdf/core）

composer require nextpdf/codeigniter

入門指南：CodeIgniter 快速開始

適用情境：法律文件數位簽章、財務報告存檔、電子發票

推薦套件：nextpdf/pro 或 nextpdf/enterprise

商業套件需透過 packagist.com 授權安裝。

入門指南：安裝指南 — 商業套件

適用情境：Edge 環境 PDF 生成、無伺服器架構

推薦套件：nextpdf/cloudflare

composer require nextpdf/cloudflare

適用情境：Claude、GPT 等 AI 工具透過 MCP 協議生成 PDF

推薦套件：nextpdf/mcp-server（支援 Core + Pro + Enterprise 工具）

入門指南：Connect (MCP Server) 文件

適用情境：無法升級 PHP 的遺留系統

推薦套件：nextpdf/backport

入門指南：PHP 相容性說明

適用情境：現有 TCPDF 程式碼庫，希望以最低成本遷移至 NextPDF

推薦套件：nextpdf/tcpdf-compat

安裝前置需求

在開始安裝之前，請確認你的環境符合以下需求：

需求 最低版本 建議版本
PHP 8.5.0 8.5.x latest
Composer 2.6 2.x latest
ext-mbstring 任何 —
ext-gd 或 ext-imagick 任何 ext-imagick 推薦
ext-openssl 任何 —
ext-fileinfo 任何 —

Backport 相容性：如需支援 PHP 8.1 或 7.4，請參閱 PHP 相容性說明。 Backport 套件透過 Rector 自動降版，維持與 Core 的功能同步。

下一步