ガイド

概要

このセクションでは、ヘッドレスの PHP 8.4 Portable Document Format 2.0 (PDF 2.0) エンジンである NextPDF の概念ドキュメントとハウツードキュメントの全体像を示します。以下の各タイルは、単一ページではなく、各セクションのハブにリンクしています。適切な出発点を見つけ、そのハブ内のリンクをたどるために利用してください。

ガイドでは how と why に答えます。タスク指向でコピーして使えるレシピが必要な場合は、代わりに Cookbook を参照してください。検証済みの API サーフェスとサポートマトリックスを確認したい場合は、Reference を参照してください。

統合ガイド

NextPDF の拡張機能は、コアエンジンをアプリケーションフレームワーク、ブラウザーレンダラー、エッジサービス、ビルドツール、およびレガシー移行と接続します。すべての拡張機能セクションは、概要、インストール、クイックスタート、構成、API、開発者ガイド、本番運用、セキュリティ、トラブルシューティングという共通のマニュアル構成に従います。

統合フレームワークアダプター (Laravel、Symfony、CodeIgniter)、レンダラーブリッジ (Artisan、Cloudflare、Gotenberg)、TCPDF 互換シム、および Backport Builder。まず拡張機能マップと選択ガイドをお読みください。

移行既存のコードベースを NextPDF に移行します。dompdf と mPDF それぞれの移行元別ガイドに加え、すべてのガイドに共通する 1 つのルールがあります。バイト単位で同一の出力ではなく、互換性のある動作であり、差異は文書化されています。

サーバーと SDK

呼び出し元がリモートにある場合、別の言語で記述されている場合、または PHP ライブラリではなくツールエンドポイントを必要とする人工知能 (AI) システムである場合は、これらのガイドを参照してください。

NextPDF Connect (サーバー) nextpdf/server パッケージ。Model Context Protocol (MCP)、Representational State Transfer (REST)、および gRPC を介して提供され、human-in-the-loop の確認ゲートの背後にある決定論的な PDF ツールレジストリです。インストール、構成、デプロイを行います。

Python SDK Python アプリケーション、エージェント、およびコマンドライン向けの、引用可能な PDF 抽出機能です。NextPDF Connect エンドポイントを基盤としています。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、フォント、タグ付け、暗号化、および権限の障害について、症状から解決策までをまとめた項目です。エンジン自身の例外分類体系に基づいています。

拡張機能の作成公開された Service Provider Interface (SPI) です。拡張できる対象、その背後にある安定性の約束、カスタムフォント、カスタムレイアウトエンジン、アクショントリガー、および Key Management Service (KMS) プロバイダー契約を扱います。

Premium (Pro および Enterprise) NextPDF Pro および Enterprise が、オープンソースのコアに追加する機能です。機能マトリックス、標準への準拠、HSM および FIPS の検証、ライセンスを扱います。商用エディションの採用にあたって、アプリケーションコードの変更は必要ありません。

コンセプト

Insider_ セクションでは、NextPDF がそのように動作する理由、つまり why を説明します。設計についてシニアエンジニアの視点を提供し、すべての主張には、その背後にある根拠の種類がタグ付けされています。

コンセプト (Insider_) 設計思想、標準の全体像、HTML パイプライン、署名と長期検証、フォント、大量生成、およびテストの手法を扱います。エンジンの設計判断を理解するには、ここから始めてください。