ディストリビューション
素の PHP → core。フレームワークアプリ → 対応する統合。ネットワーク境界 → サーバー。Python クライアント → Python SDK。
最適な導入方法を選ぶ
NextPDF には複数の導入方法があります。適切な方法は、コードをどこで実行するか、どのような出力が必要かによって決まります。このページでは、どのディストリビューションをインストールするか、どの HTML レンダラーを使用するか、どのようなワークロードで Pro または Enterprise エディションが必要になるかという 3 つの選択を整理します。
知りたい内容に該当するセクションを読むか、末尾の決定サマリーにざっと目を通してください。
ディストリビューションを選ぶ
「ディストリビューションを選ぶ」という見出しのセクションアプリケーションからエンジンをどのように呼び出すかを起点にしてください。最初にご自身の状況に当てはまる行が答えです。
| 状況 | インストール | 理由 |
|---|---|---|
| 素の PHP プロジェクト、ライブラリ、または CLI ツール | NextPDF core（nextpdf/core） | エンジン単体です。フレームワークを前提とせず、サービスとしても実行しません。 |
| Laravel、Symfony、または CodeIgniter のアプリケーション | 対応するフレームワーク統合 | core に加えて、コンテナーバインディング、レスポンスヘルパー、キュージョブを利用できます。 |
| ネットワーク経由でエンジンを呼び出す必要がある、PHP 以外のサービス、エージェント、または別のランタイム | NextPDF Server（nextpdf/server） | 単一のサービスとして、MCP、REST、gRPC 経由でエンジンを公開します。 |
| NextPDF Server から PDF を取得する必要がある Python コード | Python SDK（pip install nextpdf） | 稼働中のサーバー向けの型付きクライアントです。エンジンは組み込みません。 |
よく混同される点が 2 つあります。
- フレームワーク統合には core が 含まれます。両方を個別にインストールする必要はありません。アダプターが
nextpdf/coreを宣言し、依存関係として自動的に resolve（解決）します。 - Python SDK は クライアント であり、エンジンではありません。通信先となる NextPDF Server のエンドポイントが必要です。PDF の生成は、サーバー側の PHP で行われます。
HTML レンダラーを選ぶ
「HTML レンダラーを選ぶ」という見出しのセクションNextPDF は HTML を PDF にレンダリングする方法を 4 通り用意しています。組み込みパイプラインは、追加のセットアップなしでほとんどのドキュメントに対応します。3 つのレンダラーパッケージは、ブラウザー品質のレイアウトが必要な場合や、既存のサービスを利用したい場合に使います。
| レンダラー | パッケージ | 実行場所 | 選ぶべきケース |
|---|---|---|---|
組み込みの writeHtml() | nextpdf/core | プロセス内、純粋な PHP | ブラウザーやネットワーク呼び出しを使わず、サポート対象の HTML および CSS のサブセットを利用したい場合。 |
| Artisan | nextpdf/artisan | ホスト上のヘッドレス Chrome | flexbox、グリッド、複雑なセレクター、Web フォントなど、完全な Chrome レイアウトと選択可能なテキストが必要な場合。 |
| Cloudflare | nextpdf/cloudflare | エッジでの Cloudflare Browser Rendering | レンダリングをエッジで行う必要がある場合、または自身のホスト上でブラウザープロセスを実行したくない場合。 |
| Gotenberg | nextpdf/gotenberg | 自身で運用する Gotenberg サービス | 既存の Gotenberg デプロイメントを通じて、オフィス文書（DOCX、XLSX）または HTML を変換したい場合。 |
表の読み方は次のとおりです。
- まずは 組み込みパイプライン を利用してください。最も高速で、外部依存もありません。特定のプロパティに依存する前に、CSS サポートマトリックスと照らし合わせて確認してください。
- レイアウトがサポート対象のサブセットを超え、かつレンダリングを自身のインフラ上で行いたい場合は、Artisan へ移行してください。Chrome プロセスを起動するため、そのライフサイクルも考慮してください。
- 同じブラウザー忠実度を求めつつ、ローカルではなくエッジでレンダリングしたい場合は、Cloudflare へ移行してください。
- オフィス文書を変換する場合、またはすでに Gotenberg を運用していて NextPDF から制御したい場合は、Gotenberg へ移行してください。
Pro または Enterprise が必要になるとき
「Pro または Enterprise が必要になるとき」という見出しのセクションcore エンジンでは、ライセンス不要かつ無償で PDF の生成、レンダリング、検査を行えます。NextPDF Pro と NextPDF Enterprise は、nextpdf/premium パッケージで提供される 2 つのライセンスエディションです。インストールすると機能が追加されますが、core の API は変更されません。
| 必要な操作 | エディション | 機能 |
|---|---|---|
| PDF にデジタル署名する（PAdES ベースライン） | Pro | ソフトウェア鍵による署名の具象実装。 |
| アーカイブ用の PDF/A 出力を作成する | Pro | PDF/A 準拠およびアーカイブ用プロファイル。 |
| 電子インボイスを埋め込む（Factur-X / ZUGFeRD） | Pro | 電子インボイス契約の具象実装。 |
| ハードウェアセキュリティモジュール（HSM）で署名する | Enterprise | ハードウェアに裏付けられた鍵操作。 |
| 適格電子署名を発行する | Enterprise | 適格署名のワークフローと、コンプライアンス全体の機能。 |
判断を誤らないためのルールは 2 つです。
- 出力が署名なし、かつ非アーカイブの PDF であれば、core で完結します。ライセンスは不要です。
- パッケージ
nextpdf/premiumをインストールすると、フレームワーク統合とサーバーが 自動的にそれを検出します。追加された機能は、同一のコンテナーキーとツールカタログを通じて公開されます。これを利用するために、アプリケーションのコードを変更する必要はありません。
決定サマリー
「決定サマリー」という見出しのセクションHTML レンダラー
サポート対象のサブセット、依存なし → writeHtml()。自身のホストでのブラウザー忠実度 → Artisan。エッジで →
Cloudflare。オフィス文書の変換 → Gotenberg。
ライセンスエディション
署名なしの PDF → core。署名、PDF/A、電子インボイス → Pro。HSM または適格署名 → Enterprise。
まだ迷っていますか
まず core をインストールして はじめての PDFを実行し、具体的なニーズが生じたときにのみパッケージを追加してください。いずれも後から変更できます。
NextPDF をインストールする すべてのディストリビューションとレンダラーの正確なコマンド。
はじめての PDF PHP から PDF を生成し、HTML を PDF にレンダリングします。
統合 拡張機能の全体像、選定ガイド、およびパッケージごとのマニュアル。
接続（サーバー） MCP、REST、gRPC 経由のネットワークサービスとしてエンジンを実行します。