/EndroidGcmBundle

Google Cloud Messaging Bundle for use in Symfony

Primary LanguagePHPMIT LicenseMIT

Endroid Google Cloud Messaging Bundle

By endroid

Build Status

This bundle enables you to use the Endroid Google Cloud Messaging (endroid/Gcm) library as a decoupled service and enables configuration through the Symfony framework. Google Cloud Messaging is a service that helps developers send data from servers to their Android applications on Android devices. For more information on the services provided see the endroid/Gcm repository and Google GCM.

knpbundles.com

Requirements

Installation

Add in your composer.json

{
    "require": {
        "endroid/gcm-bundle": "dev-master"
    }
}

Install the bundle

$ curl -s http://getcomposer.org/installer | php
$ php composer.phar update endroid/gcm-bundle

Composer will install the bundle to your project's vendor/endroid directory.

Enable the bundle via the kernel

<?php
// app/AppKernel.php

public function registerBundles()
{
    $bundles = array(
        // ...
        new Endroid\Bundle\GcmBundle\EndroidGcmBundle(),
    );
}

Configuration

config.yml

endroid_gcm:
    api_key: "Your API Key (use the Browser key)"

Usage

After installation and configuration, the service can be directly referenced from within your controllers.

<?php
public function gcmSendAction()
{
    $gcm = $this->get('endroid.gcm');

    $registrationIds = array(
        // Registration ID's of devices to target
    );

    $data = array(
        'title' => 'Message title',
        'message' => 'Message body',
    );

    $response = $gcm->send($data, $registrationIds);

    ...
}

License

This bundle is under the MIT license. For the full copyright and license information, please view the LICENSE file that was distributed with this source code.