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.

useFirebase\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 = newFirebase([ 'base_url' => YOUR_FIREBASE_BASE_URL, 'token' => YOUR_FIREBASE_SECRET ], newGuzzleHttp\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.

useFirebase\Firebase;
useFirebase\Auth\TokenGenerator;
$tokenGenerator = newTokenGenerator(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.

useFirebase\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 = newGuzzleHttp\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