kreait / laravel-firebase
A Laravel package for the Firebase PHP Admin SDK
Fund package maintenance!
jeromegamez
Tidelift
Installs: 9 408 243
Dependents: 35
Suggesters: 0
Security: 0
Stars: 1 090
Watchers: 14
Forks: 174
Open Issues: 2
Requires
- php: ~8.1.0 || ~8.2.0 || ~8.3.0 || ~8.4.0
- illuminate/contracts: ^9.0 || ^10.0 || ^11.0
- illuminate/support: ^9.0 || ^10.0 || ^11.0
- kreait/firebase-php: ^7.13
- symfony/cache: ^6.1.2 || ^7.0.3
Requires (Dev)
- laravel/pint: ^1.14
- orchestra/testbench: ^7.0 || ^8.0 || ^9.0
- phpunit/phpunit: ^9.6.17 || ^10.5.13
README
A Laravel package for the Firebase PHP Admin SDK.
The future of the Firebase Admin PHP SDK
Please read about the future of the Firebase Admin PHP SDK on the SDK's GitHub Repository.
Installation
composer require kreait/laravel-firebase
Configuration
In order to access a Firebase project and its related services using a server SDK, requests must be authenticated. For server-to-server communication this is done with a Service Account.
If you don't already have generated a Service Account, you can do so by following the instructions from the official documentation pages at https://firebase.google.com/docs/admin/setup#initialize_the_sdk_in_non-google_environments.
Once you have downloaded the Service Account JSON file, you can configure the package by specifying
environment variables starting with FIREBASE_
in your .env
file. Usually, the following are
required for the package to work:
# You can find the database URL for your project at
# https://console.firebase.google.com/project/_/database
FIREBASE_DATABASE_URL=https://<your-project>.firebaseio.com
For further configuration, please see config/firebase.php. You can modify the configuration
by copying it to your local config
directory or by defining the environment variables used in the config file:
# Laravel php artisan vendor:publish --provider="Kreait\Laravel\Firebase\ServiceProvider" --tag=config
Credentials with JSON files
The package uses auto discovery for the default project to find the credentials needed for authenticating requests to the Firebase APIs by inspecting certain environment variables and looking into Google's well known path(s).
If you don't want a service account to be auto-discovered, provide it by setting the FIREBASE_CREDENTIALS
or GOOGLE_APPLICATION_CREDENTIALS
environment variable or by adapting the package configuration, like so for example:
FIREBASE_CREDENTIALS=storage/app/firebase-auth.json
Credentials with Arrays
If you prefer to have more control over the configuration items required to configure the credentials, you can also transpose the Service Account JSON file as an array within your config/firebase.php
file.
'credentials' => [ 'type' => 'service_account', 'project_id' => 'some-project-123', 'private_key_id' => '123456789', 'private_key' => '-----BEGIN PRIVATE KEY-----\nFOO_BAR_123456789\n-----END PRIVATE KEY-----\n', 'client_email' => 'firebase-adminsdk-cwiuo@some-project-123.iam.gserviceaccount.com', 'client_id' => '123456789', 'auth_uri' => 'https://accounts.google.com/o/oauth2/auth', 'token_uri' => 'https://oauth2.googleapis.com/token', 'auth_provider_x509_cert_url' => 'https://www.googleapis.com/oauth2/v1/certs', 'client_x509_cert_url' => 'https://www.googleapis.com/robot/v1/metadata/x509/firebase-adminsdk-cwiuo%40some-project-123.iam.gserviceaccount.com', 'universe_domain' => 'googleapis.com', ],
Usage
Once you have retrieved a component, please refer to the documentation of the Firebase PHP Admin SDK for further information on how to use it.
You don't need and should not use the new Factory()
pattern described in the SDK documentation, this is already
done for you with the Laravel Service Provider. Use Dependency Injection, the Facades or the app()
helper instead
Multiple projects
Multiple projects can be configured in config/firebase.php by adding another section to the projects array.
When accessing components, the facade uses the default project. You can also explicitly use a project:
use Kreait\Laravel\Firebase\Facades\Firebase; // Return an instance of the Auth component for the default Firebase project $defaultAuth = Firebase::auth(); // Return an instance of the Auth component for a specific Firebase project $appAuth = Firebase::project('app')->auth(); $anotherAppAuth = Firebase::project('another-app')->auth();
Supported Versions
Only the latest version is actively supported.
Earlier versions will receive security fixes as long as their lowest SDK requirement receives security fixes. You can find the currently supported versions and support options in the SDK's README.
License
This project is licensed under the MIT License.
Your use of Firebase is governed by the Terms of Service for Firebase Services.