NextPDF のインストール
すべての NextPDF ディストリビューションは、パッケージマネージャーのコマンド 1 つでインストールできます。PHP ディストリビューションでは Composer を、Python SDK では pip を使用します。構築する内容に合ったタブを選び、コマンドを実行してから、このページの末尾にある検証手順で結果を確認してください。
NextPDF は、最新のランタイム 1 つを対象としています。以下の制約は、各パッケージ自身の composer.json ファイルにそのまま基づいています。
| 要件 | 制約 | 備考 |
|---|---|---|
| PHP | >=8.4 <9.0 | PHP 8.3 以前または PHP 9 では Composer によるインストール不可。 |
| Composer | 2.7 以降 | 依存関係リゾルバーおよびオートローダージェネレーター。 |
ext-mbstring | 必須 | テキストレイアウトのためのマルチバイト文字列処理。 |
ext-zlib | 必須 | PDF オブジェクトのストリーム圧縮。 |
| Chrome または Chromium | 任意 | Artisan レンダラー（writeHtmlChrome()）専用。 |
| Gotenberg サービス | 任意 | Gotenberg を介したオフィス文書および HTML の変換専用。 |
| Python | 3.10 以降 | Python SDK 専用。 |
ext-mbstring と ext-zlib は、サポートされているすべての PHP ビルドで有効化された状態で提供されます。各統合は起動時にこれらをチェックし、いずれかが欠けている場合は明確なメッセージとともに停止します。
コアのインストール
「コアのインストール」という見出しのセクションPHP から PDF を生成し、検査するには、コアエンジンだけが必要です。
composer require nextpdf/core必ず composer.lock をコミットして、デプロイされたすべてのワーカーが同じエンジンバージョンに resolve（解決）されるようにしてください。インストールが完了したら、最初の PDF に進んでください。
フレームワーク統合のインストール
「フレームワーク統合のインストール」という見出しのセクションフレームワークアダプターを 1 つインストールすると、コンテナーバインディング、レスポンスヘルパー、キュージョブを利用できます。各アダプターは nextpdf/core を依存関係として宣言し、自動的に解決されます。
composer require nextpdf/laravel自動検出によって、サービスプロバイダーと Pdf ファサードが登録されます。続いて、設定ファイルをパブリッシュします。
php artisan vendor:publish --tag=nextpdf-config詳しくは、Laravel インストールガイド および Laravel クイックスタート を参照してください。
composer require nextpdf/symfonySymfony Flex アプリケーションでは、バンドルが自動的に登録されます。Flex 以外のアプリケーションでは、NextPDF\Symfony\NextPdfBundle を config/bundles.php に手動で追加します。Symfony インストールガイド を参照してください。
composer require nextpdf/codeigniterCodeIgniter 4 は Services クラスと pdf() ヘルパーを自動的に検出するため、手動で登録する必要はありません。CodeIgniter インストールガイド を参照してください。
レンダラーまたはサービスのインストール
「レンダラーまたはサービスのインストール」という見出しのセクションNextPDF は、3 つの方法で HTML を PDF にレンダリングします。レンダリングを実行する場所に合わせてインストールしてください。これらはいずれも、コアエンジンに組み込まれている純粋な PHP の HTML パイプラインである writeHtml() を置き換えるものではありません。
composer require nextpdf/artisanChrome DevTools Protocol (CDP) を介したヘッドレス Chrome レンダリングを追加します。また、ホスト上でアクセス可能な Chrome または Chromium のバイナリも必要です。インストールが完了したら、ドキュメントに対して writeHtmlChrome() を呼び出します。Artisan クイックスタート を参照してください。
composer require nextpdf/cloudflare guzzlehttp/guzzleエッジで Cloudflare Browser Rendering を介してレンダリングします。ブリッジは PSR-18 および PSR-17 のコントラクトのみに依存するため、独自の HTTP クライアントを指定してください（ここでは Guzzle を使用しています）。Cloudflare インストールガイド を参照してください。
composer require nextpdf/gotenberg guzzlehttp/guzzleGotenberg サービスを介してオフィス文書と HTML を変換します。PSR-18 クライアントとアクセス可能な Gotenberg インスタンスを用意してください。Gotenberg インストールガイド を参照してください。
サーバーのインストール
「サーバーのインストール」という見出しのセクションNextPDF Server（Connect とも呼ばれます）は、スタンドアロンのサービスです。MCP、REST、gRPC を介してエンジンを公開します。
composer require nextpdf/serverこのパッケージは、vendor/bin/ にコンソールエントリーポイントを追加します。これには vendor/bin/nextpdf-mcp（MCP stdio サーバー）と vendor/bin/nextpdf-server（REST サーバー）が含まれます。REST および gRPC のトランスポートには、RoadRunner バイナリも必要です。
./vendor/bin/rr get-binary詳しくは、Connect インストールガイド および Connect クイックスタート を参照してください。
Python SDK のインストール
「Python SDK のインストール」という見出しのセクションPython SDK は、稼働中の NextPDF Server 向けの型付きクライアントです。PyPI からインストールします。
pip install nextpdfこの SDK には、Python 3.10 以降とアクセス可能な NextPDF Server エンドポイントが必要です。Python SDK クイックスタート を参照してください。
インストールの検証
「インストールの検証」という見出しのセクションコードを書き始める前に、各ディストリビューションが正しく解決されていることを確認してください。
composer show nextpdf/coreバージョン行が表示されれば、エンジンがインストールされ、オートローダーに登録されていることを確認できます。
php artisan package:discover --ansi出力には、検出されたパッケージとして nextpdf/laravel が表示されます。
php bin/console debug:container nextpdf出力には、nextpdf.document エイリアスと PdfFactory サービスが表示されます。
./vendor/bin/generate-skills --dry-run --list-toolsこのコマンドはレジストリを起動し、実際にサーバーを起動せずに、このインストールが公開するツールを出力します。
nextpdf versionバージョン文字列が表示されれば、SDK が正常にインポートされていることを確認できます。