msouverain/rms-push-notifications-bundle

Push notifications/messages for mobile devices

Tuesday, January 20, 2015
by maxime.souverain
Repository
1 Watchers
0 Stars
14,897 Installations

PHP
0 Dependents
0 Suggesters
145 Forks
0 Open issues
9 Versions
2 % Grown

The README.md

RMSPushNotificationsBundle

A bundle to allow sending of push notifications to mobile devices. Currently supports Android (C2DM, GCM), Blackberry and iOS devices., _(*1)

Installation

To use this bundle in your Symfony2 project add the following to your composer.json:, _(*2)

{
    "require": {
        // ...
        "richsage/rms-push-notifications-bundle": "dev-master"
    }
}

and enable it in your kernel:, _(*3)

<?php
// app/AppKernel.php

public function registerBundles()
{
    $bundles = array(
        // ...
        new RMS\PushNotificationsBundle\RMSPushNotificationsBundle(),
    );
}

NOTE: If you are still using Symfony 2.0, please use the symfony2.0 branch., _(*4)

Configuration

Configuration options available are as follows. Note that the specific services will only be available if you provide configuration respectively for them., _(*5)

rms_push_notifications:
  android:
      c2dm:
          username: <string_android_c2dm_username>
          password: <string_android_c2dm_password>
          source: <string_android_c2dm_source>
      gcm:
          api_key: <string_android_gcm_api_key> # This is titled "Server Key" when creating it
          use_multi_curl: <boolean_android_gcm_use_multi_curl> # default is true
  ios:
      sandbox: <bool_use_apns_sandbox>
      pem: <path_apns_certificate> # can be absolute or relative path (from app directory)
      passphrase: <string_apns_certificate_passphrase>
  mac:
      sandbox: <bool_use_apns_sandbox>
      pem: <path_apns_certificate>
      passphrase: <string_apns_certificate_passphrase>
  blackberry:
      evaluation: <bool_bb_evaluation_mode>
      app_id: <string_bb_app_id>
      password: <string_bb_password>
  windowsphone: true

NOTE: If you are using Windows, you may need to set the Android GCM use_multi_curl flag to false for GCM messages to be sent correctly., _(*6)

Usage

A little example of how to push your first message to an iOS device, we'll assume that you've set up the configuration correctly:, _(*7)

use RMS\PushNotificationsBundle\Message\iOSMessage;

class PushDemoController extends Controller
{
    public function pushAction()
    {
        $message = new iOSMessage();
        $message->setMessage('Oh my! A push notification!');
        $message->setDeviceIdentifier('test012fasdf482asdfd63f6d7bc6d4293aedd5fb448fe505eb4asdfef8595a7');

        $this->container->get('rms_push_notifications')->send($message);

        return new Response('Push notification send!');
    }
}

The send method will detect the type of message so if you'll pass it an AndroidMessage it will automatically send it through the C2DM/GCM servers, and likewise for Mac and Blackberry., _(*8)

Android messages

Since both C2DM and GCM are still available, the AndroidMessage class has a small flag on it to toggle which service to send it to. Use as follows:, _(*9)

use RMS\PushNotificationsBundle\Message\AndroidMessage;

$message = new AndroidMessage();
$message->setGCM(true);

to send as a GCM message rather than C2DM., _(*10)

iOS Feedback service

The Apple Push Notification service also exposes a Feedback service where you can get information about failed push notifications - see here for further details., _(*11)

This service is available within the bundle. The following code demonstrates how you can retrieve data from the service:, _(*12)

$feedbackService = $container->get("rms_push_notifications.ios.feedback");
$uuids = $feedbackService->getDeviceUUIDs();

Here, $uuids contains an array of Feedback objects, with timestamp, token length and the device UUID all populated., _(*13)

Apple recommend you poll this service daily., _(*14)

Thanks

Firstly, thanks to all contributors to this bundle!, _(*15)

, _(*16)

Secondly, thanks to JetBrains for their sponsorship of an open-source PhpStorm licence for this project., _(*17)

psr/log ~1.0

by Rich Sage

bundle notification ios push gcm apns c2dm blackberry

05/09 2013

0.1.0

0.1.0.0 https://github.com/richsage/RMSPushNotificationsBundle

Push notifications/messages for mobile devices

Sources Download

MIT

The Requires

by Rich Sage

bundle notification ios push gcm apns c2dm blackberry

05/03 2013

dev-symfony2.0

dev-symfony2.0 https://github.com/richsage/RMSPushNotificationsBundle

Push notifications/messages for mobile devices

Sources Download

MIT

The Requires

by Rich Sage

bundle notification ios push gcm apns c2dm blackberry

symfony-bundle rms-push-notifications-bundle

Push notifications/messages for mobile devices

msouverain/rms-push-notifications-bundle

The README.md

RMSPushNotificationsBundle

Installation

Configuration

Usage

Android messages

iOS Feedback service

Thanks

The Versions

dev-master

The Requires

by Rich Sage

dev-bugfix-recursive

The Requires

by Rich Sage

0.1.3

The Requires

by Rich Sage

0.1.2

The Requires

by Rich Sage

0.1.1

The Requires

by Rich Sage

dev-windows-mobile

The Requires

by Rich Sage

dev-add-logger

The Requires

The Development Requires

by Rich Sage

0.1.0

The Requires

by Rich Sage

dev-symfony2.0

The Requires

by Rich Sage