firebase-php

A wrapper for the Firebase Database and Authentication API. Work in progress!

Combining the best bits of eelkevdbos/firebase-php and vinkas0/firebase-auth-laravel

##Prerequisites

• PHP >= 5.5
• Firebase >= 1.1.1
• Composer (recommended, not required)

Installation using composer (recommended)

Execute: composer require mobcomlab/firebase-php dev-master

Installation without composer

For a vanilla install, the following dependencies should be downloaded:

• firebase/php-jwt github
• guzzlehttp/guzzle github

Loading the dependencies can be achieved by using any PSR-4 autoloader.

Basic Usage

By setting your Firebase secret as token, you gain superuser access to firebase.

use Firebase\Firebase;

$fb = Firebase::initialize(YOUR_FIREBASE_URL, YOUR_FIREBASE_SECRET);

//or set your own implementation of the ClientInterface as second parameter of the regular constructor
$fb = new Firebase([ 'base_url' => YOUR_FIREBASE_BASE_URL, 'token' => YOUR_FIREBASE_SECRET ], new GuzzleHttp\Client());

//retrieve a node
$nodeGetContent = $fb->get('/node/path');

//set the content of a node
$nodeSetContent = $fb->set('/node/path', array('data' => 'toset'));

//update the content of a node
$nodeUpdateContent = $fb->update('/node/path', array('data' => 'toupdate'));

//delete a node
$nodeDeleteContent = $fb->delete('/node/path');

//push a new item to a node
$nodePushContent = $fb->push('/node/path', array('name' => 'item on list'));

Advanced Usage

For more finegrained authentication, have a look at the security rules. Using the token generator allows you to make use of the authentication services supplied by Firebase.

use Firebase\Firebase;
use Firebase\Auth\TokenGenerator;

$tokenGenerator = new TokenGenerator(YOUR_FIREBASE_SECRET);

$token = $tokenGenerator->generateToken(['email' => 'test@example.com'])

$fb = Firebase::initialize(YOUR_FIREBASE_BASE_URL, $token);

The above snippet of php interacts with the following security rules:

{
  "rules": {
    ".read": "auth.email == 'test@example.com'"
    ".write": "auth.email == 'admin@example.com'"
  }
}

And will allow the snippet read-access to all of the nodes, but not write-access.

##Concurrent requests Execution of concurrent requests can be achieved with the same syntax as regular requests. Simply wrap them in a Closure and call the closure via the batch method and you are all set.

use Firebase\Firebase;

$fb = Firebase::initialize(YOUR_FIREBASE_BASE_URL, YOUR_FIREBASE_SECRET);

$requests = $fb->batch(function ($client) {
    for($i = 0; $i < 100; $i++) {
        $client->push('list', $i);
    }
});

$pool = new GuzzleHttp\Pool($fb->getClient(), $requests);
$pool->wait();

Laravel integration

Integration for Laravel 5.2+ is supported. A service provider and a facade class are supplied. Installation is done in 2 simple steps after the general installation steps:

1. edit app/config/app.php to add the service provider and the facade class

    'providers' => [
      ...
      Firebase\Integration\Laravel\FirebaseServiceProvider::class,
    ]
    
    'aliases' => [
      ...
      'Firebase' => Firebase\Integration\Laravel\Firebase::class,
    ]

2. edit app/config/services.php to add your Firebase settings

    'firebase' => [
      'project_id' => YOUR_FIREBASE_PROJECT_ID,
      'auth_domain' => YOUR_FIREBASE_BASE_URL,
      'api_key' => YOUR_FIREBASE_SECRET
    ]

Now you should be able to call Firebase::get('/node/path') directly.

##Eventing

The library supports the EventEmitter pattern. The event-emitter is attached to the Firebase class. Events currently available:

• RequestsBatchedEvent