google-gemini-php/client

这是什么？

核心功能

• 01支持文本、图片、视频、音频和文档输入。
• 02提供流式输出和多轮对话会话。
• 03可通过 Schema 或 JSON Schema 约束输出结构化 JSON。
• 04支持函数调用，以及 Google 搜索、代码执行等内置工具。
• 05提供文件上传、上下文缓存和文件搜索存储管理。
• 06附带 fake 客户端，便于编写测试。

适用场景

• 在 Laravel 或其他 PHP 后端中加入 Gemini 驱动的对话或内容生成功能。
• 从文档或图片中提取结构化数据，输出为 JSON。
• 基于 File Search 对上传文档进行检索增强问答。
• 为调用 Gemini 的 PHP 代码编写单元测试，无需访问真实 API。

快速上手

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 是什么？

社区维护的 PHP 客户端，用于调用 Gemini API，覆盖文本、多媒体、流式输出与工具调用等功能。 Gemini PHP 是一个由社区维护的 PHP 客户端，用于调用 Google 的 Gemini API。PHP 应用可以向 Gemini 模型发送文本、图片、视频、音频和文档输入，并支持流式输出、多轮对话、结构化 JSON 输出和函数调用。

client 可以免费使用吗？用的什么许可证？

client 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

client 还在维护吗？

活跃维护中。client 最近一次提交是在 2026年10月12日。

client 适合用来做什么？

在 Laravel 或其他 PHP 后端中加入 Gemini 驱动的对话或内容生成功能。 从文档或图片中提取结构化数据，输出为 JSON。 基于 File Search 对上传文档进行检索增强问答。 为调用 Gemini 的 PHP 代码编写单元测试，无需访问真实 API。

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