google-gemini-php/client

これは何？

主な機能

• 01テキスト、画像、動画、音声、ドキュメントの入力に対応しています。
• 02ストリーミング応答と複数ターンのチャットセッションを利用できます。
• 03スキーマまたはJSON Schema形式の配列を使って、構造化JSON出力を取得できます。
• 04関数呼び出しと、Google Searchやコード実行などの組み込みツールを利用できます。
• 05ファイルのアップロード、コンテキストキャッシュ、File Searchストアを利用できます。
• 06テスト用のfake clientが付属しています。

ユースケース

• LaravelなどのPHPバックエンドに、Geminiを活用したチャットやコンテンツ生成機能を追加する。
• ドキュメントや画像から構造化データを抽出し、型付きJSONに変換する。
• File Searchを使い、アップロードしたドキュメントを対象に検索拡張生成（RAG）による回答を構築する。
• 実際のAPIを呼び出さずに、Geminiを利用するPHPコードのユニットテストを書く。

クイックスタート

1. 1

   Composer で PHP 8.2 以降のパッケージをインストールします

   composer require google-gemini-php/client
2. 2

   プロジェクトに PSR-18 HTTP クライアントがない場合はインストールします

   composer require guzzlehttp/guzzle
3. 3

   Google AI Studio で Gemini API キーを作成します

4. 4

   API キーを使ってクライアントを作成し、gemini-2.5-flash で generateContent を呼び出します

使う前に知っておきたいこと

• !PHP 8.2 以降が必要です。
• !Google AI Studio で取得した Gemini API キーが必要です。
• !バージョン 2.0 は Gemini v1beta API でのみ動作します。

トピック

よくある質問

client とは？

テキスト、メディア、ストリーミング、ツール、ファイルやキャッシュの管理に対応した、コミュニティ開発のGemini API向けPHPクライアント。 Gemini PHPは、GoogleのGemini API向けにコミュニティがメンテナンスしているPHP APIクライアントです。PHPアプリケーションからテキスト、画像、動画、音声、ドキュメントをGeminiモデルに送信でき、ストリーミング、複数ターンのチャット、構造化JSON出力、関数呼び出しにも対応しています。

client は無料で使えますか？ライセンスは？

client は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

client は今もメンテナンスされていますか？

活発にメンテナンス中。client の最終コミットは 2026年10月12日 です。

client は何に使えますか？

LaravelなどのPHPバックエンドに、Geminiを活用したチャットやコンテンツ生成機能を追加する。 ドキュメントや画像から構造化データを抽出し、型付きJSONに変換する。 File Searchを使い、アップロードしたドキュメントを対象に検索拡張生成（RAG）による回答を構築する。 実際のAPIを呼び出さずに、Geminiを利用するPHPコードのユニットテストを書く。

client のインストール方法は？

Composer で PHP 8.2 以降のパッケージをインストールします: composer require google-gemini-php/client プロジェクトに PSR-18 HTTP クライアントがない場合はインストールします: composer require guzzlehttp/guzzle Google AI Studio で Gemini API キーを作成します API キーを使ってクライアントを作成し、gemini-2.5-flash で generateContent を呼び出します

client はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/google-gemini-php/client