PHPackages                             kreait/firebase-bundle - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Database &amp; ORM](/categories/database)
4. /
5. kreait/firebase-bundle

ActiveSymfony-bundle[Database &amp; ORM](/categories/database)

kreait/firebase-bundle
======================

Symfony Bundle for the Firebase Admin SDK

6.1.0(2mo ago)1534.7M↓10.4%29[1 issues](https://github.com/beste/firebase-bundle/issues)2MITPHPPHP ~8.3.0 || ~8.4.0 || ~8.5.0CI passing

Since Jan 23Pushed 2mo ago6 watchersCompare

[ Source](https://github.com/beste/firebase-bundle)[ Packagist](https://packagist.org/packages/kreait/firebase-bundle)[ Docs](https://github.com/beste/firebase-bundle)[ GitHub Sponsors](https://github.com/sponsors/jeromegamez)[ RSS](/packages/kreait-firebase-bundle/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (14)Versions (47)Used By (2)

Firebase SDK Bundle
===================

[](#firebase-sdk-bundle)

A Symfony Bundle for the [Firebase PHP SDK](https://github.com/beste/firebase-php).

[![Current version](https://camo.githubusercontent.com/f1e23939ec257ff13fb2c03e249a26a21c909869f56ef24a169c700720ebf802/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6b72656169742f66697265626173652d62756e646c652e7376673f6c6f676f3d636f6d706f736572)](https://packagist.org/packages/kreait/firebase-bundle)[![Monthly Downloads](https://camo.githubusercontent.com/98f7880ca670a1c116b9fc8cd848cf1e37c71d87576089d035445e0764e0bf74/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646d2f6b72656169742f66697265626173652d62756e646c652e737667)](https://packagist.org/packages/kreait/firebase-bundle/stats)[![Total Downloads](https://camo.githubusercontent.com/200dd0c3632b711160b3fec360d0827592cad8d526fcc419cc3547f7b7252af3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6b72656169742f66697265626173652d62756e646c652e737667)](https://packagist.org/packages/kreait/firebase-bundle/stats)[![Tests](https://github.com/beste/firebase-bundle/actions/workflows/tests.yml/badge.svg)](https://github.com/beste/firebase-bundle/actions/workflows/tests.yml)[![Sponsor](https://camo.githubusercontent.com/1004a94551d1edaf2a6da4d45ba217b79a46eb18dd7dd2d7825add0a2a8ddc4f/68747470733a2f2f696d672e736869656c64732e696f2f7374617469632f76313f6c6f676f3d476974487562266c6162656c3d53706f6e736f72266d6573736167653d25453225394425413426636f6c6f723d666636396234)](https://github.com/sponsors/jeromegamez)

Important

**Support the project:** The [Firebase PHP SDK](https://github.com/beste/firebase-php) is downloaded 1M+ times monthly and powers thousands of applications. If it saves you or your team time, please consider [sponsoring its development](https://github.com/sponsors/jeromegamez).

Note

The project moved from the `kreait` to the `beste` GitHub Organization in January 2026. The namespace remains `Kreait\Firebase\Symfony\Bundle` and the package name remains `kreait/firebase-bundle`. Please update your remote URL if you have forked or cloned the repository.

- [Overview](#overview)
- [Installation](#installation)
- [Supported Versions](#supported-versions)
- [Documentation](#documentation)
- [License](#license)

Overview
--------

[](#overview)

[Firebase](https://firebase.google.com/) provides the tools and infrastructure you need to develop your app, grow your user base, and earn money. The Firebase Admin PHP SDK enables access to Firebase services from privileged environments (such as servers or cloud) in PHP.

For more information, visit the [Firebase Admin PHP SDK documentation](https://firebase-php.readthedocs.io/).

Installation
------------

[](#installation)

Add the bundle using [Composer](https://getcomposer.org)

```
composer require kreait/firebase-bundle
```

```
// Symfony without Flex
// in %kernel.root_dir%/AppKernel.php
$bundles = array(
    // ...
    new Kreait\Firebase\Symfony\Bundle\FirebaseBundle(),
);

// Symfony with Flex
// in config/bundles.php
return [
    // ...
    Kreait\Firebase\Symfony\Bundle\FirebaseBundle::class => ['all' => true],
];
```

Configuration
-------------

[](#configuration)

### Minimal

[](#minimal)

```
# app/config/config.yml (Symfony without Flex)
# config/packages/firebase.yaml (Symfony with Flex)
kreait_firebase:
    projects:
        my_project:
            credentials: '%kernel.project_dir%/config/my_project_credentials.json'
        other_project: # optional
            credentials: '%kernel.project_dir%/config/other_project_credentials.json'
```

The following services will be available for your project:

- `kreait_firebase.my_project.app_check`
- `kreait_firebase.my_project.auth`
- `kreait_firebase.my_project.database`
- `kreait_firebase.my_project.firestore`
- `kreait_firebase.my_project.messaging`
- `kreait_firebase.my_project.remote_config`
- `kreait_firebase.my_project.storage`
- `kreait_firebase.other_project.*`

The following classes will be available for dependency injection if you have configured only one project:

- `Kreait\Firebase\Contract\AppCheck`
- `Kreait\Firebase\Contract\Auth`
- `Kreait\Firebase\Contract\Database`
- `Kreait\Firebase\Contract\Firestore`
- `Kreait\Firebase\Contract\Messaging`
- `Kreait\Firebase\Contract\RemoteConfig`
- `Kreait\Firebase\Contract\Storage`

To make it easier to use classes via dependency injection in the constructor of a class when multiple projects exist, you can do this in the constructor:

- `Kreait\Firebase\Contract\AppCheck $myProjectAppCheck`
- `Kreait\Firebase\Contract\Auth $myProjectAuth`
- `Kreait\Firebase\Contract\Database $myProjectDatabase`
- `Kreait\Firebase\Contract\Firestore $myProjectFirestore`
- `Kreait\Firebase\Contract\Messaging $myProjectMessaging`
- `Kreait\Firebase\Contract\RemoteConfig $myProjectRemoteConfig`
- `Kreait\Firebase\Contract\Storage $myProjectStorage`

### Full

[](#full)

```
# app/config/config.yml (Symfony without Flex)
# config/packages/firebase.yaml (Symfony with Flex)
kreait_firebase:
    projects:
        my_project:
            # Optional: Path to the project's Service Account credentials file
            # If omitted, the credentials will be auto-discovered as described
            # in https://firebase-php.readthedocs.io/en/stable/setup.html
            credentials: '%kernel.project_dir%/config/my_project_credentials.json'
            # Optional: Override the project being used
            # If omitted, the project is automatically derived, e.g. from credentials
            project_id: 'project-b'
            # Optional: If set to true, this project will be used when
            # type hinting the component classes of the Firebase SDK,
            # e.g. Kreait\Firebase\Auth, Kreait\Firebase\Database,
            # Kreait\Firebase\Messaging, etc.
            default: false
            # Optional: If set to false, the service and its alias can only be
            # used via dependency injection, and not be retrieved from the
            # container directly.
            public: true
            # Optional: Should only be used if the URL of your Realtime
            # Database can not be generated with the project id of the
            # given Service Account
            database_uri: 'https://my_project.firebaseio.com'
            # Optional: Make the client tenant aware
            tenant_id: 'tenant-id'
            # Optional: Used to cache Google's public keys for ID Token verification.
            verifier_cache: null # Example: cache.app
            # Optional: Used to cache the authentication tokens for connecting to the Firebase servers.
            auth_token_cache: null # Example: cache.app
            # Optional: Used to cache Google's public keys for AppCheck token verification.
            key_set_cache: null # Example: cache.app
            # Optional: Service id of Kreait\Firebase\Http\HttpClientOptions
            # used to configure the SDK's HTTP client.
            http_client_options: null # Example: app.firebase.http_client_options
```

Documentation
-------------

[](#documentation)

For documentation of the underlying SDK, visit the [Firebase Admin PHP SDK documentation](https://firebase-php.readthedocs.io/).

License
-------

[](#license)

This project is licensed under the [MIT License](LICENSE).

Your use of Firebase is governed by the [Terms of Service for Firebase Services](https://firebase.google.com/terms/).

###  Health Score

72

—

ExcellentBetter than 100% of packages

Maintenance87

Actively maintained with recent releases

Popularity61

Solid adoption and visibility

Community30

Small or concentrated contributor base

Maturity93

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 65.9% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~94 days

Recently: every ~128 days

Total

44

Last Release

66d ago

Major Versions

2.6.0 → 3.0.02021-11-30

2.x-dev → 3.1.02021-12-04

3.x-dev → 4.0.02022-01-09

4.1.0 → 5.0.02023-01-13

5.7.0 → 6.0.02026-02-17

PHP version history (9 changes)1.8.0PHP ^7.0

2.0.0PHP ^7.2

2.3.0PHP ^7.2|^8.0

2.6.0PHP ^7.4|^8.0

5.0.0PHP ~8.1.0 || ~8.2.0

5.1.0PHP ~8.1.0 || ~8.2.0 || ~8.3.0

5.5.0PHP ~8.1.0 || ~8.2.0 || ~8.3.0 || ~8.4

5.7.0PHP ~8.1.0 || ~8.2.0 || ~8.3.0 || ~8.4.0 || ~8.5.0

6.0.0PHP ~8.3.0 || ~8.4.0 || ~8.5.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/8685cf532053a084f1eade7b7da00a512c02676e65f1f1bdec73d4978030a47d?d=identicon)[jeromegamez](/maintainers/jeromegamez)

---

Top Contributors

[![jeromegamez](https://avatars.githubusercontent.com/u/67554?v=4)](https://github.com/jeromegamez "jeromegamez (139 commits)")[![iamtankist](https://avatars.githubusercontent.com/u/1786341?v=4)](https://github.com/iamtankist "iamtankist (23 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (17 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (15 commits)")[![tanukijs](https://avatars.githubusercontent.com/u/25182349?v=4)](https://github.com/tanukijs "tanukijs (2 commits)")[![heiglandreas](https://avatars.githubusercontent.com/u/91998?v=4)](https://github.com/heiglandreas "heiglandreas (2 commits)")[![JeremieSamson](https://avatars.githubusercontent.com/u/5656168?v=4)](https://github.com/JeremieSamson "JeremieSamson (1 commits)")[![kmeretskyi](https://avatars.githubusercontent.com/u/131363630?v=4)](https://github.com/kmeretskyi "kmeretskyi (1 commits)")[![rogierknoester](https://avatars.githubusercontent.com/u/4541046?v=4)](https://github.com/rogierknoester "rogierknoester (1 commits)")[![simonhayre](https://avatars.githubusercontent.com/u/1636647?v=4)](https://github.com/simonhayre "simonhayre (1 commits)")[![szepeviktor](https://avatars.githubusercontent.com/u/952007?v=4)](https://github.com/szepeviktor "szepeviktor (1 commits)")[![tjveldhuizen](https://avatars.githubusercontent.com/u/779998?v=4)](https://github.com/tjveldhuizen "tjveldhuizen (1 commits)")[![adpeyre](https://avatars.githubusercontent.com/u/12408697?v=4)](https://github.com/adpeyre "adpeyre (1 commits)")[![WedgeSama](https://avatars.githubusercontent.com/u/1552205?v=4)](https://github.com/WedgeSama "WedgeSama (1 commits)")[![AJ-computerrock](https://avatars.githubusercontent.com/u/12999898?v=4)](https://github.com/AJ-computerrock "AJ-computerrock (1 commits)")[![AliMsayleb](https://avatars.githubusercontent.com/u/44602883?v=4)](https://github.com/AliMsayleb "AliMsayleb (1 commits)")[![Bleksak](https://avatars.githubusercontent.com/u/5411554?v=4)](https://github.com/Bleksak "Bleksak (1 commits)")[![eriwin](https://avatars.githubusercontent.com/u/3142606?v=4)](https://github.com/eriwin "eriwin (1 commits)")[![HossamYoussof](https://avatars.githubusercontent.com/u/6381926?v=4)](https://github.com/HossamYoussof "HossamYoussof (1 commits)")

---

Tags

firebasefirebase-adminfirebase-admin-sdkfirebase-authfirebase-authenticationfirebase-cloud-messagingfirebase-databasefirebase-dbfirebase-firestorefirebase-storagefirestorephprealtime-databasesymfonysymfony-bundleapisymfonybundlesdkgoogledatabasefirebaseSymfony Bundle

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/kreait-firebase-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/kreait-firebase-bundle/health.svg)](https://phpackages.com/packages/kreait-firebase-bundle)
```

###  Alternatives

[kreait/laravel-firebase

A Laravel package for the Firebase PHP Admin SDK

1.3k16.5M42](/packages/kreait-laravel-firebase)[kreait/firebase-php

Firebase Admin SDK

2.4k39.7M72](/packages/kreait-firebase-php)[morrislaptop/firestore-php

Firestore SDK for PHP without gRPC

6928.6k1](/packages/morrislaptop-firestore-php)[cmsig/seal-symfony-bundle

An integration of CMS-IG SEAL search abstraction into Symfony Framework.

15195.8k5](/packages/cmsig-seal-symfony-bundle)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
