Skip to content
This repository has been archived by the owner. It is now read-only.
Firebase Token Generator for PHP
Branch: master
Clone or download
samtstern Prepare for archiving (#36)
* Prepare for archiving

* Line break
Latest commit 4a7ab75 Aug 24, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
src Add missing sprintf variable Nov 16, 2015
.travis.ini Add configuration for Travis CI May 31, 2015
.travis.yml Add configuration for Travis CI May 31, 2015
LICENSE Update year in license May 31, 2015 Prepare for archiving (#36) Aug 24, 2018
composer.json Remove deprecated code and calls Oct 18, 2015
phpunit.xml.dist Refactor TokenGenerator May 31, 2015

Status: Archived

This repository has been archived and is no longer maintained.

status: inactive

Firebase Token Generator - PHP

WARNING: This token generator is compatible with versions 1.x.x and 2.x.x of the Firebase SDK. If you are using the 3.x.x SDK, please refer to the documentation here.

Firebase Custom Login gives you complete control over user authentication by allowing you to authenticate users with secure JSON Web Tokens (JWTs). The auth payload stored in those tokens is available for use in your Firebase security rules. This is a token generator library for PHP which allows you to easily create those JWTs.


The Firebase PHP token generator library depends on PHP-JWT.

A Note About Security

IMPORTANT: Because token generation requires your Firebase Secret, you should only generate tokens on trusted servers. Never embed your Firebase Secret directly into your application and never share your Firebase Secret with a connected client.


Using composer:

composer require firebase/token-generator

Generating Tokens

To generate tokens, you'll need your Firebase Secret which you can find by entering your Firebase URL into a browser and clicking the "Secrets" tab on the left-hand navigation menu.

Once you've downloaded the library and grabbed your Firebase Secret, you can generate a token with this snippet of PHP code:

use Firebase\Token\TokenException;
use Firebase\Token\TokenGenerator;

try {
    $generator = new TokenGenerator('<YOUR_FIREBASE_SECRET>');
    $token = $generator
        ->setData(array('uid' => 'exampleID'))
} catch (TokenException $e) {
    echo "Error: ".$e->getMessage();

echo $token;

The payload passed to setData() is made available for use within your security rules via the auth variable. This is how you pass trusted authentication details (e.g. the client's user ID) to your Firebase security rules. The payload can contain any data of your choosing, however it must contain a "uid" key, which must be a string of less than 256 characters. The generated token must be less than 1024 characters in total.

Token Options

Token options can be set to modify how Firebase treats the token. Available options are:

  • expires (number or DateTime) - A timestamp (as number of seconds since the epoch) or a DateTime denoting the time after which this token should no longer be valid.

  • notBefore (number or DateTime) - A timestamp (as number of seconds since the epoch) or a DateTime denoting the time before which this token should be rejected by the server.

  • admin (boolean) - Set to True if you want to disable all security rules for this client. This will provide the client with read and write access to your entire Firebase database.

  • debug (boolean) - Set to True to enable debug output from your security rules. You should generally not leave this set to True in production (as it slows down the rules implementation and gives your users visibility into your rules), but it can be helpful for debugging.

Here is an example of how to set options:

use Firebase\Token\TokenGenerator;

$generator = new TokenGenerator('<YOUR_FIREBASE_SECRET>');

// Using setOption()
$token = $generator
    ->setOption('admin', true)
    ->setOption('debug', true)
    ->setData(array('uid' => 'exampleID'))

// Using setOptions()
$token = $generator
        'admin' => true,
        'debug' => true
    ->setData(array('uid' => 'exampleID'))


3.0.0 - 2015-11-18

  • Update PHP-JWT to >= 3.0
  • Remove deprecated Services_FirebaseTokenGenerator and update tests
  • Thanks to @jeromegamez for the above contributions!

2.1.0 - 2015-06-22

2.0.1 - 2015-04-02

  • Specifying the PHP-JWT version more specifically.

2.0.0 - 2014-09-15

  • Additional validation to ensure tokens contain a "uid" field unless they have the "admin" option set to true.

1.0.0 - 2014-09-04

  • Initial release
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.