インテグレーションクックブック

NextPDF core は PHP から PDF 2.0 をレンダリングします。エコシステムに含まれる 9 つのインテグレーションパッケージは、このエンジンをフレームワーク、レンダリングバックエンド、レガシーコードベース、ビルドパイプライン、またはネットワークサービスに接続します。このページでは、各インテグレーションの用途を説明し、それぞれのパッケージ名と core バージョン制約を（各パッケージの composer.json から直接読み取って）記録し、各インテグレーションのクイックスタートレシピへのリンクを示します。

このページはインデックスであるため、いずれのインテグレーションについても動作に関する主張は行いません。各インテグレーションのレシピは、そのインテグレーション自身のリポジトリが所有し、アグリゲーターがそれらを本サイトに公開します。ユースケースに基づく推奨については、インテグレーションの選択をお読みください。実行可能なすべてのレシピが従う規約については、レシピの規約をお読みください。

5 つのインテグレーションの形態

9 つのパッケージは 5 つの形態に分類されます。形態を見ると、そのインテグレーションがどのような種類の問題に対処するものかが分かります。

フレームワークインテグレーション は、NextPDF をアプリケーションフレームワークのサービスコンテナとリクエストライフサイクルに組み込みます：nextpdf/laravel、nextpdf/symfony、nextpdf/codeigniter。いずれか 1 つをインストールし、サービスを resolve（解決）して、PDF レスポンスを返します。
レンダラーブリッジ は、HTML から PDF、または Office から PDF への変換ステップを、インプロセスのパイプラインではなく外部のレンダリングバックエンドに委譲します：nextpdf/artisan（Chrome DevTools Protocol 経由のヘッドレス Chrome）、nextpdf/gotenberg（Gotenberg マイクロサービス）、nextpdf/cloudflare（エッジでの Cloudflare Browser Rendering）。
互換シム は、レガシーな PDF ライブラリ向けに書かれたコードベースが、書き換えなしで NextPDF を呼び出せるようにします：nextpdf/compat-legacy。
ビルドツール は、8.4 を実行できないランタイム向けに NextPDF の PHP 8.1 / 7.4 バックポートを生成します：nextpdf/backport-builder。
ネットワークサービス は、AI システムやリモートの呼び出し元向けに、REST、gRPC、および Model Context Protocol を通じて NextPDF を公開します：nextpdf/server（NextPDF Connect として配布）。

HTTP を用いるレンダラーブリッジ（nextpdf/gotenberg、nextpdf/cloudflare、および nextpdf/laravel 内の HTTP クライアントパス）は、ホストアプリケーションが提供する PSR-18 HTTP クライアントに依存します。PSR-18 クライアントは、リクエストをまったく送信できない場合にのみ、型付けされたクライアント例外を送出します。これは、適用される PSR-18 §4 で規定されているとおりです。HTTP の 4xx または 5xx レスポンスは、例外ではなく通常の戻り値です。これも同じ PSR-18 §4 に規定されています。リモートレンダラーを呼び出すレシピは、トランスポートエラーと非成功ステータスを 2 つの別々のケースとして処理します。

パッケージと core 制約のリファレンス

以下の各値は、記載されているパッケージの composer.json（信頼できる情報源）から読み取ったものです。core 制約は、パッケージが宣言する nextpdf/core の要件です。nextpdf/backport-builder は nextpdf/core の要件を宣言しません。これは、実行時にエンジンへ依存するのではなく、エンジンのソースを変換するためです。

インテグレーション	パッケージ	形態	core の制約	レシピ
Laravel	`nextpdf/laravel`	フレームワーク	`^3.0 \|\| ^5.2`	Laravel クイックスタート
Symfony	`nextpdf/symfony`	フレームワーク	`^3.0 \|\| ^5.2`	Symfony クイックスタート
CodeIgniter 4	`nextpdf/codeigniter`	フレームワーク	`^3.0 \|\| ^5.2`	CodeIgniter クイックスタート
Artisan（Chrome ブラウザー）	`nextpdf/artisan`	レンダラーブリッジ	`^3.0 \|\| ^5.2`	Artisan クイックスタート
Gotenberg	`nextpdf/gotenberg`	レンダラーブリッジ	`^3.0`	Gotenberg クイックスタート
Cloudflare	`nextpdf/cloudflare`	レンダラーブリッジ	`^3.0`	Cloudflare クイックスタート
Compat（レガシー）	`nextpdf/compat-legacy`	互換シム	`^3.0`	TCPDF-compat クイックスタート
Backport ビルダー	`nextpdf/backport-builder`	ビルドツール	該当なし	Backport クイックスタート
Connect（サーバー）	`nextpdf/server`	ネットワークサービス	`^3.0`	Connect クイックスタート

NextPDF は nextpdf/server を製品名 NextPDF Connect として配布します。そのレシピは最上位の connect スラッグの下に配置されます。nextpdf/compat-legacy は compat ファミリーから提供されます。そのレシピは、エミュレートする対象にちなんで名付けられた tcpdf-compat スラッグの下に配置されます。

いずれのパッケージも、自身のランタイムで PHP >=8.4 <9.0 を必要とします。nextpdf/backport-builder は、PHP 8.1（および 7.4 ターゲット）で実行されるアーティファクトを生成するために特別に存在します。古いランタイムで実行されるのは、ビルダーではなく、生成されたバックポート済みのエンジンです。

各インテグレーションの用途

フレームワークインテグレーション

nextpdf/laravel — Laravel 12 のサービスプロバイダー、ファサード、および PDF レスポンスヘルパーです。アプリケーションが Laravel アプリであり、手作業による配線なしで NextPDF をコンテナから解決して HTTP レスポンスとして返したい場合に使用します。レシピ：Laravel クイックスタート。
nextpdf/symfony — 依存性注入サービスと PDF レスポンスヘルパーを備えた Symfony 7 のバンドルです。アプリケーションが Symfony アプリである場合に使用します。このバンドルはエンジンをサービスとして登録し、symfony/http-foundation のレスポンスと統合します。レシピ：Symfony クイックスタート。
nextpdf/codeigniter — CodeIgniter 4 のサービス、ライブラリラッパー、および PDF レスポンスヘルパーです。アプリケーションが CodeIgniter 4 アプリであり、フレームワークのサービスロケーターを通じて NextPDF を利用したい場合に使用します。レシピ：CodeIgniter クイックスタート。

レンダラーブリッジ

nextpdf/artisan — Chrome DevTools Protocol を介したヘッドレス Chrome レンダラーです。ドキュメントで、インプロセスの HTML パイプラインでは対象外となるレイアウト忠実度を得るためにブラウザーの CSS エンジンが必要であり、かつアプリケーションの近くで Chrome プロセスを実行できる場合に使用します。レシピ：Artisan クイックスタート。
nextpdf/gotenberg — Gotenberg マイクロサービスを通じた、Office から PDF および HTML から PDF への変換です。入力が Office ドキュメントである場合、またはレンダリングを別のサービスでアウトオブプロセスで実行する必要がある場合に使用します。このインテグレーションは、ホストが提供する PSR-18 クライアントを介して HTTP で通信します。レシピ：Gotenberg クイックスタート。
nextpdf/cloudflare — Cloudflare Browser Rendering API を介したサーバーレスレンダリングです。長時間稼働のブラウザープロセスを運用せず、レンダリングをエッジで実行したい場合に使用します。このインテグレーションは、ホストが提供する PSR-18 クライアントを介して HTTP で通信します。レシピ：Cloudflare クイックスタート。

互換シム

nextpdf/compat-legacy — レガシーな PDF ライブラリ向けに書かれたコードベースのための互換レイヤーです。呼び出し箇所を先に書き換えることなく、既存のコードから NextPDF を呼び出すために使用します。これは移行を補助するものであり、恒久的な依存関係ではありません。レシピ：TCPDF-compat クイックスタート。

ビルドツール

nextpdf/backport-builder — NextPDF の PHP 8.1（および 7.4 ターゲット）ビルドを生成する、Rector ベースのダウングレードパイプラインです。ランタイムを PHP 8.4 に移行できないものの、その環境でエンジンを必要とする場合に使用します。これはビルドインフラストラクチャであり、アプリケーションのランタイム依存関係には追加されません。レシピ：Backport クイックスタート。

ネットワークサービス

nextpdf/server（NextPDF Connect） — NextPDF を REST API、gRPC サービス、および Model Context Protocol を通じて公開します。呼び出し元がリモートにある場合、別の言語で記述されている場合、または PHP ライブラリではなくツールエンドポイントを必要とする AI システムである場合に使用します。レシピ：Connect クイックスタート。

レシピのスラッグの構成方法

レシピは /integrations/<integration>/<recipe>/ の下に配置されます。ここで <integration> は、上記のリファレンス表から取得される短い名前です（Connect のレシピは、代わりに最上位の connect スラッグの下に配置されます）。各インテグレーションが最初に提供するレシピは quickstart という名前です。それ以降のレシピは、追加の <recipe> セグメントを同じルートの下で使用します。このインデックスは、いずれのターゲットページについても動作に関する主張は行いません。記録するのは、composer.json から検証されたパッケージの事実と、各リポジトリのレシピが使用するスラッグのみです。