NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #1633 most downloaded on Packagist
Gemini API is a supercharged PHP API client that allows you to interact with the Gemini API
Latest stable
2.8.0
Last release 1 months ago
12 Oct 2026
Ships unpredictably
gaps range from 1 weeks to 10 months
Nearly every release is documented
notes for 31 of 32 stable releases
Nothing withdrawn
no release was ever pulled
3 years old
40 releases · first in 2024
Drag across the ruler to compare, or tap a release to open it.
PHP 8.2+ is now required. Projects on PHP 8.1 will keep resolving to 2.7.x.
ImageConfig::$imageSize, response metadata (responseId, modelStatus, finishMessage, urlContextMetadata, serviceTier), and importFile() / getOperation() for file search stores.ClientFake now supports startChat(), including multi-turn and streamed chats.No public signatures changed, but a few behaviors did:
ErrorException instead of TransporterException, like regular requests (#187).streamSendMessage() keeps thoughts, function calls and tool calls as separate parts and keeps their thoughtSignature. This fixes the next turn being rejected after a streamed function call, but $chat->history[$i]->parts may look different than before (#183).ValueError messages of text() and parts() now end with the finish or block reason (#189).Full Changelog: https://github.com/google-gemini-php/client/compare/2.7.4...2.8.0
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Make thinkingBudget optional in ThinkingConfig by @foremtehan in https://github.com/google-gemini-php/client/pull/162
Full Changelog: https://github.com/google-gemini-php/client/compare/2.7.3...2.7.4
Add ThinkingLevel enum by @foremtehan in https://github.com/google-gemini-php/client/pull/161
Full Changelog: https://github.com/google-gemini-php/client/compare/2.7.2...2.7.3
feat: Add Interval class with RFC 3339 validation and GoogleSearch time filtering by @millyhung in https://github.com/google-gemini-php/client/pull/15
Full Changelog: https://github.com/google-gemini-php/client/compare/2.7.1...2.7.2
Bug fix by @aydinfatih in https://github.com/google-gemini-php/client/pull/152
Full Changelog: https://github.com/google-gemini-php/client/compare/2.7.0...2.7.1
Add ImageConfig to GenerationConfig and add new FinishReason types. by @shaxaaa in https://github.com/google-gemini-php/client/pull/145
Full Changelog: https://github.com/google-gemini-php/client/compare/2.6.0...2.7.0
Fix: Clarify HTTP client variable in factory example by @rema424 in https://github.com/google-gemini-php/client/pull/132
Full Changelog: https://github.com/google-gemini-php/client/compare/2.5.0...2.6.0
Added thoughts bool to indicate thoughts by @Plytas in https://github.com/google-gemini-php/client/pull/131
thoughts bool to indicate thoughts by @Plytas in https://github.com/google-gemini-php/client/pull/131Full Changelog: https://github.com/google-gemini-php/client/compare/2.4.0...2.5.0
Added urlContext support by @Plytas in https://github.com/google-gemini-php/client/pull/128
urlContext support by @Plytas in https://github.com/google-gemini-php/client/pull/128Full Changelog: https://github.com/google-gemini-php/client/compare/2.3.1...2.4.0
Add Type for UploadedFile by @rodnaph in https://github.com/google-gemini-php/client/pull/123
Full Changelog: https://github.com/google-gemini-php/client/compare/2.3.0...2.3.1
Fix readme code examples by @Plytas in https://github.com/google-gemini-php/client/pull/117
Full Changelog: https://github.com/google-gemini-php/client/compare/2.2.0...2.3.0
Add List and Delete methods to Files API by @khartnett in https://github.com/google-gemini-php/client/pull/114
Full Changelog: https://github.com/google-gemini-php/client/compare/2.1.2...2.2.0
docs(readme): fix gemini class import error by @dushmanta05 in https://github.com/google-gemini-php/client/pull/109
Full Changelog: https://github.com/google-gemini-php/client/compare/2.1.1...2.1.2
Fix some nullable attributes in GoogleGrounding response classes by @maximetassy in https://github.com/google-gemini-php/client/pull/107
Full Changelog: https://github.com/google-gemini-php/client/compare/2.1.0...2.1.1
add file test resource by @mayconmedeiroz in https://github.com/google-gemini-php/client/pull/102
Full Changelog: https://github.com/google-gemini-php/client/compare/2.0.0...2.1.0
Deprecate ModelType enum by @Plytas in https://github.com/google-gemini-php/client/pull/99
Please refer to updagrade guide for more information.
ModelType enum by @Plytas in https://github.com/google-gemini-php/client/pull/99PromptFeedback by @200-0K in https://github.com/google-gemini-php/client/pull/80Full Changelog: https://github.com/google-gemini-php/client/compare/1.0.15...2.0.0
Update README.md for correct example using custom model by @devaex in https://github.com/google-gemini-php/client/pull/59
GenerativeModelTestResource with GenerativeModel by @Plytas in https://github.com/google-gemini-php/client/pull/57Full Changelog: https://github.com/google-gemini-php/client/compare/1.0.14...1.0.15
refactor: Make nullable uri variable in CitationSource by @aydinfatih in https://github.com/google-gemini-php/client/pull/55
CitationSource by @aydinfatih in https://github.com/google-gemini-php/client/pull/55Full Changelog: https://github.com/google-gemini-php/client/compare/1.0.13...1.0.14
refactor: Make nullable license variable in CitationSource by @aydinfatih in https://github.com/google-gemini-php/client/pull/52
CitationSource by @aydinfatih in https://github.com/google-gemini-php/client/pull/52Full Changelog: https://github.com/google-gemini-php/client/compare/1.0.12...1.0.13
Optional license by @canparam in https://github.com/google-gemini-php/client/pull/49
Full Changelog: https://github.com/google-gemini-php/client/compare/1.0.11...1.0.12
refactor: Make the $finishReason parameter in Candidate nullable by @aydinfatih in https://github.com/google-gemini-php/client/pull/46
$finishReason parameter in Candidate nullable by @aydinfatih in https://github.com/google-gemini-php/client/pull/46Full Changelog: https://github.com/google-gemini-php/client/compare/1.0.10...1.0.11
Support for tuned models by @gregpriday in https://github.com/google-gemini-php/client/pull/41
Full Changelog: https://github.com/google-gemini-php/client/compare/1.0.9...1.0.10
Update MimeType.php adding application/pdf by @tfranca2 in https://github.com/google-gemini-php/client/pull/39
Full Changelog: https://github.com/google-gemini-php/client/compare/1.0.8...1.0.9
Fix issue Undefined array key "candidatesTokenCount" by @lamberttraccard in https://github.com/google-gemini-php/client/pull/37
Full Changelog: https://github.com/google-gemini-php/client/compare/1.0.7...1.0.8
feat: Add batchEmbedContents method to embeddingModel by @aydinfatih in https://github.com/google-gemini-php/client/pull/33
Full Changelog: https://github.com/google-gemini-php/client/compare/1.0.6...1.0.7
Update README.md for correct example using custom model by @devaex in https://github.com/google-gemini-php/client/pull/59
GenerativeModelTestResource with GenerativeModel by @Plytas in https://github.com/google-gemini-php/client/pull/57Full Changelog: https://github.com/google-gemini-php/client/compare/1.0.14...1.0.15
GenerativeModelTestResource with GenerativeModel by @Plytas in https://github.com/google-gemini-php/client/pull/57$outputDimensionality param to embedContent methodFull Changelog: https://github.com/google-gemini-php/client/compare/1.0.6-beta...1.0.7-beta
Add deprecated annotation to gemini pro vision usages
Full Changelog: https://github.com/google-gemini-php/client/compare/1.0.5...1.0.6
refactor: Make nullable uri variable in CitationSource by @aydinfatih in https://github.com/google-gemini-php/client/pull/55
CitationSource by @aydinfatih in https://github.com/google-gemini-php/client/pull/55Full Changelog: https://github.com/google-gemini-php/client/compare/1.0.5-beta...1.0.6-beta
[Mime] Add new types for images, videos, and plain text by @bradleybernard in https://github.com/google-gemini-php/client/pull/22
Full Changelog: https://github.com/google-gemini-php/client/compare/1.0.4...1.0.5
refactor: Make nullable license variable in CitationSource by @aydinfatih in https://github.com/google-gemini-php/client/pull/52
CitationSource by @aydinfatih in https://github.com/google-gemini-php/client/pull/52Full Changelog: https://github.com/google-gemini-php/client/compare/1.0.4-beta...1.0.5-beta
fix: Fixed an error due to recitation finish reason by @aydinfatih in https://github.com/google-gemini-php/client/pull/9
Full Changelog: https://github.com/google-gemini-php/client/compare/1.0.3...1.0.4
feat: Add system promt support for beta by @davidgustys in https://github.com/google-gemini-php/client/pull/45
Full Changelog: https://github.com/google-gemini-php/client/compare/1.0.3-beta...1.0.4-beta
Added startChat method to ChatSessionContract by @aydinfatih in https://github.com/google-gemini-php/client/pull/5
Full Changelog: https://github.com/google-gemini-php/client/compare/1.0.2...1.0.3
refactor: Make the $finishReason parameter in Candidate nullable by @aydinfatih in https://github.com/google-gemini-php/client/pull/46
$finishReason parameter in Candidate nullable by @aydinfatih in https://github.com/google-gemini-php/client/pull/46Full Changelog: https://github.com/google-gemini-php/client/compare/1.0.2-beta...1.0.3-beta
Added default header by @aydinfatih in https://github.com/google-gemini-php/client/pull/2
Full Changelog: https://github.com/google-gemini-php/client/compare/1.0.1...1.0.2
Fix issue Undefined array key "candidatesTokenCount" by @lamberttraccard in https://github.com/google-gemini-php/client/pull/37
Full Changelog: https://github.com/google-gemini-php/client/compare/1.0.1-beta...1.0.2-beta
Allow custom model name by @aydinfatih in https://github.com/google-gemini-php/client/pull/1
Full Changelog: https://github.com/google-gemini-php/client/compare/1.0.0...1.0.1
Full Changelog: https://github.com/google-gemini-php/client/compare/1.0.0-beta...1.0.1-beta
Full Changelog: https://github.com/google-gemini-php/client/compare/1.0.0-beta...1.0.1-beta
Nothing published for this version
feat: Added Structured Output feature for Beta by @aydinfatih in https://github.com/google-gemini-php/client/pull/34
One column per month.