クックブック

概要

クックブックは、タスク別に整理されています。各レシピは、コピーして使える、ソースに裏付けられたサンプルで 1 つの問題を解決します。レシピは、処理の実行場所ごとに整理された 3 つのファミリーに分類されます。NextPDF の呼び出し方法に合うファミリーを選び、その中から必要なレシピを選択してください。

エンジンが特定の動作をする理由を理解したい場合は、代わりにガイドをお読みください。検証済みの API サーフェスが必要な場合は、リファレンスをお読みください。

PHP レシピ

PHP レシピは、コアエンジンをプロセス内で直接使用します。いずれのレシピも composer require nextpdf/core でインストールするところから始まり、その後、パブリック API を使ってドキュメントの作成、署名、検査、または変換を行います。たとえば Document::createStandalone() や writeHtml() などです。

PHP レシピすべての PHP ネイティブレシピのマップです。HTML から PDF へのレンダリング、テーブルのレイアウト、フォントの埋め込みとサブセット化、AES-256 による暗号化、PAdES による署名、PDF/A-4 およびタグ付き PDF/UA-2 の出力、テキストの抽出、既存ファイルの検査を扱います。

Connect レシピ

Connect レシピは、Model Context Protocol（MCP）、Representational State Transfer（REST）、または gRPC を介して、サーバーのツールレジストリ経由で NextPDF を呼び出します。同じツール呼び出しが、ヒューマンインザループの確認ゲートを介して、3 つのトランスポートすべてで動作します。

Connect レシピ NextPDF Connect サーバー向けの、トランスポートに依存しないレシピです。hello world、HTML テーブル、画像の埋め込み、電子署名、アクセシビリティおよびコンプライアンスチェック、墨消し、フォレンジック分析、OpenTelemetry による可観測性を扱います。

統合レシピ

統合レシピは、NextPDF をアプリケーションフレームワークに組み込むか、レンダリングを外部バックエンドに委譲します。フレームワークアダプター、レンダラーブリッジ、さらにレガシーライブラリからの移行パスを扱います。

統合レシピエコシステムパッケージ向けのレシピです。統合の選択、フレームワークコントローラーからの PDF の返却、バックグラウンドジョブでの生成のキューイング、Artisan による HTML のレンダリング、Gotenberg による Office ファイルの変換、Cloudflare によるエッジでのレンダリング、TCPDF 移行パスの追跡を扱います。

レシピの規約

すべてのレシピは、明文化された契約に従います。具体的には、ソースに裏付けられたサンプル、再現性プロファイルのフロントマター、適合境界の誠実な明示、そして公開ゲートです。サンプルを適用する前に、作業対象のファミリーの規約ページをお読みください。

統合レシピの規約実行可能なすべての統合レシピが従う契約です。ソースに裏付けられたサンプル、再現性プロファイルのフロントマター、そして公開ゲートです。

Connect レシピの規約すべての Connect レシピが従う契約です。トランスポートに依存しないツール呼び出し、ティア条件付きツール、リスクモデルと確認ゲート、そして正直な適合境界です。