NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist, #497 most downloaded on Packagist
Firebase Admin SDK
Latest stable
8.7.0
Last release today
21 Nov 2026
Release timing varies
gaps range from 2 weeks to 4 months
Nearly every release is documented
notes for 59 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
12 years old
250 releases · first in 2015
Drag across the ruler to compare, or tap a release to open it.
Added Firebase Emulator support
Added support for Remote Config experiment values
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Added support for providing a PSR-14 event dispatcher to the factory.
Added support for providing a PSR-14 event dispatcher to the factory.
Kreait\Firebase\Auth now dispatches events for user changes, refresh-token revocation, and sent email action links.Kreait\Firebase\Messaging now dispatches events for sent messages and validation errors.Kreait\Firebase\RemoteConfig now dispatches events for published and rolled-back templates.Re-release of 8.4.1 because its tag pointed to the wrong commit.
Re-release of 8.4.1 because its tag pointed to the wrong commit.
Fixed retrieving templates containing missing parameter groups ( #1133 ).
Full Changelog: 8.4.0...8.4.1
Added support for guzzlehttp/guzzle:^8.0 , guzzlehttp/psr7:^3.0 and guzzlehttp/promises:^3.0 .
guzzlehttp/guzzle:^8.0, guzzlehttp/psr7:^3.0 and guzzlehttp/promises:^3.0.firebase/php-jwt constraint to ^7.0.2.guzzlehttp/guzzle:^8.0, guzzlehttp/psr7:^3.0 and guzzlehttp/promises:^3.0.firebase/php-jwt constraint to ^7.0.2. Although
CVE-2025-45769 is rated as low severity, it has been
disputed on the basis that applications, rather than
the library, are responsible for choosing appropriate key lengths. Nevertheless, a review of the library's
most-downloaded dependents
showed that most already support version 7.x.Updated dependency mtdowling/jmespath.php to 2.9.2 to address CVE-2026-54133
mtdowling/jmespath.php to 2.9.2 to address CVE-2026-54133Added support for Unicode characters in email addresses.
verifyTokenWithReplayProtection(). The response now includes alreadyConsumed when replay protection is used.Kreait\Firebase\Contract\AppCheckWithReplayProtection. This was introduced to preserve backwards compatibility by avoiding a signature change to Kreait\Firebase\Contract\AppCheck::verifyToken() in the current major release.Kreait\Firebase\Exception\AppCheck\FailedToVerifyAppCheckReplayProtection for replay-protection verification failures. It extends Kreait\Firebase\Exception\AppCheck\FailedToVerifyAppCheckToken for backwards compatibility.Important
Support the project: This SDK is downloaded 1M+ times monthly and powers thousands of applications.
If it saves you or your team time, please consider sponsoring its development.
Added support for firebase/php-jwt:^7.0.2
Added support for firebase/php-jwt:^7.0.2
Important
Support the project: This SDK is downloaded 1M+ times monthly and powers thousands of applications.
If it saves you or your team time, please consider sponsoring its development.
Deprecated classes, methods and class constants have been removed.
#[SensitiveParameter] attributes to methods handling sensitive data (passwords, tokens, private keys)
to prevent them from appearing in stack traces and error logs.Stringable|string to string).Kreait\Firebase\Contract\Transitional\FederatedUserFetcher::getUserByProviderUid() method
has been moved into the Kreait\Firebase\Contract\Auth interfacepsr/log has been moved from runtime dependencies to development dependenciesKreait\Firebase\Contract\Messaging::BATCH_MESSAGE_LIMIT constant has been removedKreait\Firebase\Messaging\CloudMessage builder methods have been renamed to follow the with* pattern:
toToken() -> withToken(), toTopic() -> withTopic(), toCondition() -> withCondition().
The old methods are deprecated but still available as aliases.See UPGRADE-8.0 for more details on the changes between 7.x and 8.0.
https://github.com/kreait/firebase-php/blob/7.24.0/CHANGELOG.md
[!IMPORTANT] Support the project: This SDK is downloaded 1M+ times monthly and powers thousands of applications. If it saves you or your team time, please consider sponsoring its development.
Added support for firebase/php-jwt:^7.0.2 to remediate the vulnerabilities PKSA-y2cr-5h3j-g3ys and CVE-2025-4659 .
Added support for firebase/php-jwt:^7.0.2 to remediate the vulnerabilities PKSA-y2cr-5h3j-g3ys and CVE-2025-4659.
Important
Support the project: This SDK is downloaded 1M+ times monthly and powers thousands of applications.
If it saves you or your team time, please consider sponsoring its development.
Realtime Database references are now validated by the API instead of locally. Validation rules can change at any time, and the SDK can only adapt to c
#[SensitiveParameter] attribute again, because it's supported by PHP 8.1 itself, but not in combination with Valinor. (#1034)[!IMPORTANT] Support the project: This SDK is downloaded 1M+ times monthly and powers thousands of applications. If it saves you or your team time, please consider sponsoring its development.
Require cuyz/valinor:^2.2.1 for better mapping.
Require cuyz/valinor:^2.2.1 for better mapping.
The project now features a custom logo (I came up with it myself, and took the wise decision to not look up if there's something similar already)
[!IMPORTANT] Support the project: This SDK is downloaded 1M+ times monthly and powers thousands of applications. If it saves you or your team time, please consider sponsoring its development.
Re-added the #[SensitiveParameter] attribute because, while it's not supported in PHP 8.1, it can still be used if placed in a standalone line above t
#[SensitiveParameter] attribute because, while it's not supported in PHP 8.1, it can still be used if placed in a standalone line above the variable or property.Removed the #[SensitiveParameter] attribute because it's not supported in PHP 8.1.
Removed the #[SensitiveParameter] attribute because it's not supported in PHP 8.1.
This release introduces Valinor for type-safe object mapping. The first application is mapping a given service account file, JSON, or array to the new
This release introduces Valinor for type-safe object mapping. The first application is mapping a given service account file, JSON, or array to the newly added internal ServiceAccount class, with more to follow in future releases.
Since this method couldn't be added to the Kreait\Firebase\Contract\Auth interface without causing a breaking change, a new transitional interface/con…
You can now get a user by their federated identity provider (e.g. Google, Facebook, etc.) UID with Kreait\Firebase\Auth::getUserByProviderUid(). (#1000).
Since this method couldn't be added to the Kreait\Firebase\Contract\Auth interface without causing a breaking change, a new transitional interface/contract named Kreait\Firebase\Contract\Transitional\FederatedUserFetcher was added. This interface will be removed in the next major version of the SDK.
There are several ways to check if you can use the getUserByProviderUid() method:
use Kreait\Firebase\Contract\Transitional\FederatedUserFetcher;
use Kreait\Firebase\Factory;
$auth = (new Factory())->createAuth();
// The return type is Kreait\Firebase\Contract\Auth, which doesn't have the method
if (method_exists($auth, 'getUserByProviderUid')) {
$user = $auth->getUserByProviderUid('google.com', 'google-uid');
}
if ($auth instanceof \Kreait\Firebase\Auth) { // This is the implementation, not the interface
$user = $auth->getUserByProviderUid('google.com', 'google-uid');
}
if ($auth instanceof FederatedUserFetcher) {
$user = $auth->getUserByProviderUid('google.com', 'google-uid');
}
Kreait\Firebase\Factory::withDefaultCache() allows you to set a default cache implementation for the SDK. This is useful if you want to use one cache implementation for all components that support caching. (Documentation)Kreait\Firebase\Factory::getDebugInfoFull Changelog: https://github.com/kreait/firebase-php/compare/7.19.0...7.20.0
You can now save on method call by passing a custom Firestore database name to Kreait\Firebase\Factory::createFirestore($databaseName) instead of havi
Kreait\Firebase\Factory::createFirestore($databaseName) instead of having to chain ::withFirestoreDatabase($databaseName)->createFirestore()Kreait\Firebase\Http\HttpClientOptions::withGuzzleMiddleware() and Kreait\Firebase\Http\HttpClientOptions::withGuzzleMiddlewares() now accept callable strings, in addition to callables. (#1004)Kreait\Firebase\Factory::withFirestoreDatabase()It is now possible to configure multi factor authentication for a user.
It is now possible to configure multi factor authentication for a user.
FCM Error responses with status code 502 are now caught and converted to ServerUnavailable exceptions.
FCM Error responses with status code 502 are now caught and converted to ServerUnavailable exceptions.
It wasn't possible to upgrade the SDK to a newer version because it required a lcobucci/jwt release that doesn't support PHP 8.1 anymore. This was fix
It wasn't possible to upgrade the SDK to a newer version because it required a lcobucci/jwt release that doesn't support PHP 8.1 anymore. This was fixed by changing the version requirement from ^5.4.2 to ^5.3.
[!IMPORTANT] The SDK is celebrating its 10th anniversary this month! If you’ve found value in my work on this project over the years, I’d be truly grateful if you considered showing your support by becoming a Sponsor. Thank you for helping keep this journey going!
Deprecated the CloudMessage::withTarget() method, use the new toToken(), toTopic() or toCondition() methods instead
HttpClientOptions::withGuzzleHandler() method. (#956)CloudMessage class for message handling anymore. If you provide a message as an array and it has an error, the Firebase API will report it. You can still use the CloudMessage class as a message builderCloudMessage::withTarget() method, use the new toToken(), toTopic() or toCondition() methods insteadKreait\Firebase\Messaging\CloudMessage::withTarget()Kreait\Firebase\Messaging\CloudMessage::withChangedTarget()Kreait\Firebase\Messaging\CloudMessage::target()Kreait\Firebase\Messaging\CloudMessage::hasTarget()Added support for rollout parameter values in Remote Config Templates. (#923),
Added support for rollout parameter values in Remote Config Templates. (#923), (#927)
Please note that it's not (yet?) possible to create rollouts programmatically via the Firebase API. This means that you have to manually create a rollout in the Firebase console to be able to reference it in the Remote Config template. Rollout IDs are named rollout_<number>, and you can find the ID in the URL after clicking on a rollout in the list.
Firebase Dynamic Links is deprecated and should not be used in new projects. The service will shut down on August 25, 2025. The component will remain…
Added support for PHP 8.4.
[!NOTE] While the SDK supports PHP 8.4, not all dependencies support it. If you want to use the SDK with PHP 8.4, you probably will need to ignore platform requirements when working with Composer, by setting the appropriate environment variables or
composerCLI options when runningcomposer install/update/require.
Firebase Dynamic Links is deprecated and should not be used in new projects. The service will shut down on August 25, 2025. The component will remain in the SDK until then, but as the Firebase service is deprecated, this component is also deprecated. (Dynamic Links Deprecation FAQ)
Requests to the FCM APIs will not use HTTP/2 if the environment doesn't support them (#888, #908)
Service Account auto-discovery was done on instantiation of the Factory, causing it to fail when credentials weren't ready yet. It will now be done th
Catch Throwable and let the exception converter handle details
It is now possible to get a Remote Config template by its version number.
It is now possible to get a Remote Config template by its version number. (#890)
FCM Messages are now sent asynchronously using HTTP connection pooling with HTTP/2. This should improve performance when sending messages to many devi
Re-enabled the use of psr/http-message v1.0
Re-enabled the use of psr/http-message v1.0 (#850)
Nothing published for this version
Added Kreait\Firebase\Factory::withFirestoreClientConfig() to support setting additional options when creating the Firestore component. (Documentation
Kreait\Firebase\Factory::withFirestoreClientConfig() to support setting additional options when
creating the Firestore component. (Documentation)Kreait\Firebase\Factory::withFirestoreDatabase() to specify the database used when creating the Firestore
component. (Documentation)Required transitive dependencies directly (#842) `json5 { "require": { // ... "ext-filter": "*", "guzzlehttp/promises": "^2.0", "guzzlehttp/psr7": "^2
{
"require": {
// ...
"ext-filter": "*",
"guzzlehttp/promises": "^2.0",
"guzzlehttp/psr7": "^2.6",
"psr/clock": "^1.0",
"psr/http-client": "^1.0",
"psr/http-factory": "^1.0",
"psr/http-message": "^2.0",
}
}
The Kreait\Firebase\Exception\Messaging\NotFound exception now exposes the token that hasn't been found with the token() method.
The Kreait\Firebase\Exception\Messaging\NotFound exception now exposes the token that hasn't been found with the token() method. (#825)
Added FCM error handling to the documentation
Unless funding is found to continue maintaining this project and the underlying SDK, maintenance will be halted.
The cached KeySet used by the AppCheck component didn't use the same Guzzle Config Options as the other clients
The cached KeySet used by the AppCheck component didn't use the same Guzzle Config Options as the other clients (#812)
Replaced calls to deprecated FCM batch endpoints with asynchronous requests to the HTTP V1 API (#804/#805)
Removed obsolete internal classes
Kreait\Firebase\Http\HasSubRequestsKreait\Firebase\Http\HasSubResponsesKreait\Firebase\Http\RequestsKreait\Firebase\Http\RequestWithSubRequestsKreait\Firebase\Http\ResponsesKreait\Firebase\Http\ResponseWithSubResponsesKreait\Firebase\Http\WrappedPsr7ResponseKreait\Firebase\Http\WrappedPsr7RequestKreait\Firebase\Messaging\Http\Request\MessageRequestKreait\Firebase\Messaging\Http\Request\SendMessageKreait\Firebase\Messaging\Http\Request\SendMessageToTokensKreait\Firebase\Messaging\Http\Request\SendMessagesRemoved obsolete internal methods
Kreait\Firebase\Http\Middleware::responseWithSubResponses()Removed obsolete Composer dependency riverline/multipart-parser
Kreait\Firebase\RemoteConfig\DefaultValue should be regarded as deprecated, it is kept to not create a breaking changes
Kreait\Firebase\RemoteConfig\ExplicitValue is deprecatedKreait\Firebase\RemoteConfig\DefaultValue should be regarded as deprecated, it is kept to not create a breaking changesRemoved direct dependency to psr/http-message
Removed direct dependency to psr/http-message
It is now possible to add config options and middlewares to the Guzzle HTTP Client performing the HTTP Requests to the Firebase APIs through the HttpC
It is now possible to add config options and middlewares to the Guzzle HTTP Client performing the HTTP Requests to the Firebase APIs through the HttpClientOptions class. (Documentation)
Fixed a user's MFA information not being correctly parsed
Fixed a user's MFA information not being correctly parsed (#783)
Added support for the Firebase Auth Emulator when using lcobucci/jwt 5.*
Added support for the Firebase Auth Emulator when using lcobucci/jwt 5.*
Added support for lcobucci/jwt 5.*
Added support for lcobucci/jwt 5.*
Restored support for using a JSON string in the GOOGLE_APPLICATION_CREDENTIALS environment variable.
Restored support for using a JSON string in the GOOGLE_APPLICATION_CREDENTIALS environment variable. (#767)
Cloud Messaging: The APNS content-available payload field was not set correctly when a message contained message data at the root level, but not at th
Cloud Messaging: The APNS content-available payload field was not set correctly when a message contained message data at the root level, but not at the APNS config level. (#762)
When trying to work with unknown FCM tokens, errors returned from the Messaging REST API were not passed to the NotFound exception, which prevented th
NotFound exception, which prevented the inspection of further details. (#760)The most notable change is that you need PHP 8.1/8.2 to use the new version. The language migration of the SDK introduces breaking changes concerning…
The most notable change is that you need PHP 8.1/8.2 to use the new version. The language migration of the SDK introduces breaking changes concerning the strictness of parameter types almost everywhere in the SDK. However, this should not affect your project in most cases (unless you have used internal classes directly or by extension).
This release adds many more PHPDoc annotations to support the usage of Static Analysis Tools like PHPStan and Psalm and moves away from doing runtime checks. It is strongly recommended to use a Static Analysis Tool and ensure that input values are validated before handing them over to the SDK.
withServiceAccount() method of the Factory or by setting the GOOGLE_APPLICATION_CREDENTIALS environment variable. Depending on the environment in which the SDK is running, credentials could be auto-discovered otherwise, for example, on GCP or GCE.See UPGRADE-7.0 for more details on the changes between 6.x and 7.0.
Removed direct dependency to psr/http-message
Removed direct dependency to psr/http-message
Cloud Messaging: The APNS apns-push-type header and content-available payload field were not set correctly when a message contained message data at th
Cloud Messaging: The APNS apns-push-type header and content-available payload field were not set correctly when a message contained message data at the root level, but not at the APNS config level. (#762)
When trying to work with unknown FCM tokens, errors returned from the Messaging REST API were not passed to the NotFound exception, which prevented th
NotFound exception, which prevented the inspection of further details. (backported from #760)When no Service Account was provided, custom token were generated with a direct call to the Google Identity Toolkit, which could create invalid token
When no Service Account was provided, custom token were generated with a direct call to the Google Identity Toolkit, which could create invalid token signatures depending on the environment (e.g. GCE). Now, the provided credentials are used to sign custom tokens via the Kreait\Firebase\Auth\CustomTokenViaGoogleCredentials class. This is an internal class and should not be used directly. (#745)
Kreait\Firebase\Auth\CustomTokenViaGoogleIam (internal)
Removed "replace": {"symfony/polyfill-mbstring": "*"} from composer.json because it made SDK updates uninstallable in projects that require other libr
Removed "replace": {"symfony/polyfill-mbstring": "*"} from composer.json because it made SDK updates uninstallable in projects that require other libraries needing it. (#742)
Added Kreait\Firebase\RemoteConfig\Template::conditionNames() to return a list of condition names of a Remote Config template
Kreait\Firebase\RemoteConfig\Template::conditionNames() to return a list of condition names of a Remote Config templateKreait\Firebase\RemoteConfig\Template::withRemovedCondition(string $name) to remove a condition from a Remote Config template by nameAdded support for Remote Config Personalization (#731/#733)
Kreait\Firebase\RemoteConfig\Template::withRemovedParameter(string $name) to remove an existing parameter from a Remote Config TemplateKreait\Firebase\RemoteConfig\Template::withRemovedParameterGroup(string $name) to remove an existing parameter group from a Remote Config TemplateKreait\Firebase\RemoteConfig\DefaultValue::useInAppDefault()Kreait\Firebase\RemoteConfig\DefaultValue::IN_APP_DEFAULT_VALUEKreait\Firebase\RemoteConfig\DefaultValue::none()Kreait\Firebase\RemoteConfig\DefaultValue::value()Added Auth::queryUsers() to process subsets of users with more parameters than Auth::listUsers(). listUsers() is a fast and memory-efficient way to pr
Added Auth::queryUsers() to process subsets of users with more parameters than Auth::listUsers(). listUsers() is a fast and memory-efficient way to process a large list of users. queryUsers() provides sorting and filtering by given fields and pagination. (#727/#728) (Documentation)
Limits and filters were not applied to Realtime Database Queries
Added support for the Firebase Auth Emulator. (#722) (Documentation)
The WebPushConfig class is now more lenient with TTL values, and urgencies are checked if they are valid
The AndroidConfig class is now more lenient with TTL values (#713
AndroidConfig class is now more lenient with TTL values (#713Kreait\Firebase\Contract\Messaging::BATCH_MESSAGE_LIMITOne column per quarter.