issetbv/push-notification

PushNotification is a push message abstraction which allows you to easily send push notifications to mobile devices. Currently we support Apple, Android and Windows (experimental)

Wednesday, April 19, 2017
by IssetBV
Repository
4 Watchers
1 Stars
3,389 Installations

PHP
1 Dependents
0 Suggesters
1 Forks
0 Open issues
11 Versions
16 % Grown

The README.md

IssetBV/PushNotification

, _(*1)

PushNotification is a push message abstraction which allows you to easily send push notifications to mobile devices. Currently we support Apple, Android and Windows (experimental), _(*2)

Why Yet Another Notification Package

There are many packages out there that support mobile push notification, but most do not support an unified API.
Some implementations were lacking flexible logging capabilities
Most implementations did not support batches/queues
Most implementations did not take into account that when sending batches to Apple, if one of the messages fails, the entire batch is dropped. This means that if you have a queue of 50 messages and the 3rd message fails, 47 messages will be dropped. This frustrated us to no end, so we build a simple yet effective fallback mechanism that will restart the batch from the first message after the failed one.

Goals

Have a generic API for sending push notifications regardless of device.
Have consistent output.
Integrate well with other packages/frameworks.
Have a flexible logging mechanism.
Have build in queue mechanism.
Have build in queue resume when dealing with batches (specifically sent to Apple).

Prerequisites

PHP 7.0+
cURL

Installation

Through Composer:, _(*3)

  composer require issetbv/push-notification

Integrations

At the moment we only support Symfony, since that's what we use, but feel free to create your own, and send us a PR with a link to your integration, _(*4)

Symfony integration: https://github.com/Isset/pushnotification-bundle

Supported Devices

Android
Apple
Windows (experimental)

Documentation

The bulk of the documentation is stored in the docs/index.md file in this package:, _(*5)

Read the Documentation, _(*6)

If you just want to send a message without using the NotificationCenter here are some simple TL;DR examples, _(*7)

Simple Android Example

To send a push notification to an Android device we first need to setup a connection. A connection needs a name, api url and your api key. Lastly we need the device token of the device we want to send the message to., _(*8)

    use IssetBV\PushNotification\Type\Android\AndroidConnection;
    use IssetBV\PushNotification\Type\Android\Message\AndroidMessage;

    $connection = new AndroidConnection(
        $name,    // 'android'
        $api_url, // 'https://fcm.googleapis.com/fcm/send'
        $api_key, // 'super-secret-api-key
    );

    $message = new AndroidMessage('my-device-token');
    $message->addToPayload('notification', ['title' => 'Test android']);

    $response = $connection->sendAndReceive($message);

    echo $response->isSuccess(); // should be true

Simple Apple Example

To send a push notification to an Apple device we first need to setup a connection. A connection needs a name, api url, location of the pem file and the passphrase of the pem file (if the pem file has one). Lastly we need the device identifier of the device we want to send the message to., _(*9)

    use IssetBV\PushNotification\Type\Apple\AppleConnection;
    use IssetBV\PushNotification\Type\Apple\Message\AppleMessageAps;

    $connection = new AppleConnection(
        $name,      // 'apple'
        $api_url,   // 'ssl://gateway.push.apple.com:2195'  
        $pemFile,   // __DIR__ '/pemfile.pem'
        $passPhrase // 'super-secret-passphrase'
    );

    $appleMessage = new AppleMessageAps('my-device-identifier');
    // see notes below as to why we don't use ->addToPayload()
    $appleMessage->getAps()->setAlert('Test apple');    

    $response = $connection->sendAndReceive($appleMessage);

    echo $response->isSuccess(); // should be true

When sending messages to Apple, the payload can have a specific key named aps where we can specify that it should show a notification on the screen. For more information, visit the official Apple documentation regarding the message format., _(*10)

Simple Windows Example

To send a push notification to a Windows device we first need to setup a connection. A connection only needs a name. Differently than with Android or Apple, the Windows message needs the uri of your specific device to deliver the message., _(*11)

    use IssetBV\PushNotification\Type\Windows\Message\WindowsMessage;
    use IssetBV\PushNotification\Type\Windows\WindowsConnection;

    $connection = new WindowsConnection('windows');

    $windowsMessage = new WindowsMessage('https://cloud.notify.windows.com/?token=AQE%bU%2fSjZOCvRjjpILow%3d%3d');
    $windowsMessage->addToPayload('wp:Text1', 'Test Windows');

    $response = $connection->sendAndReceive($windowsMessage);

    echo $response->isSuccess(); // should be true

The Versions

19/04 2017

dev-feature/windows_notification

dev-feature/windows_notification http://www.isset.nl

PushNotification is a push message abstraction which allows you to easily send push notifications to mobile devices. Currently we support Apple, Android and Windows (experimental)

Sources Download

MIT

The Requires

The Development Requires

by Felix Balfoort

apple ios push windows android mobile notifications push notifications windowsphone push messages

05/04 2017

dev-master

9999999-dev http://www.isset.nl

PushNotification is a push message abstraction which allows you to easily send push notifications to mobile devices. Currently we support Apple, Android and Windows (experimental)

Sources Download

MIT

The Requires

The Development Requires

by Felix Balfoort

apple ios push windows android mobile notifications push notifications windowsphone push messages

05/04 2017

dev-develop

dev-develop http://www.isset.nl

PushNotification is a push message abstraction which allows you to easily send push notifications to mobile devices. Currently we support Apple, Android and Windows (experimental)

Sources Download

MIT

The Requires

The Development Requires

by Felix Balfoort

apple ios push windows android mobile notifications push notifications windowsphone push messages

05/04 2017

1.2.0

1.2.0.0 http://www.isset.nl

PushNotification is a push message abstraction which allows you to easily send push notifications to mobile devices. Currently we support Apple, Android and Windows (experimental)

Sources Download

MIT

The Requires

The Development Requires

by Felix Balfoort

apple ios push windows android mobile notifications push notifications windowsphone push messages

04/04 2017

1.1.0

1.1.0.0 http://www.isset.nl

PushNotification is a push message abstraction which allows you to easily send push notifications to mobile devices. Currently we support Apple, Android and Windows (experimental)

Sources Download

MIT

The Requires

The Development Requires

by Felix Balfoort

apple ios push windows android mobile notifications push notifications windowsphone push messages

04/04 2017

dev-feature/added-readme-and-nicer-api-fixes

dev-feature/added-readme-and-nicer-api-fixes http://www.isset.nl

PushNotification is a push message abstraction which allows you to easily send push notifications to mobile devices. Currently we support Apple, Android and Windows (experimental)

Sources Download

MIT

The Requires

The Development Requires

by Felix Balfoort

apple ios push windows android mobile notifications push notifications windowsphone push messages

04/04 2017

1.0.4

1.0.4.0 http://www.isset.nl

Sources Download

MIT

The Requires

The Development Requires

by Felix Balfoort

09/03 2017

1.0.3

1.0.3.0 http://www.isset.nl

Sources Download

MIT

The Requires

by Felix Balfoort

08/03 2017

1.0.2

1.0.2.0 http://www.isset.nl

Sources Download

MIT

The Requires

by Felix Balfoort

08/03 2017

1.0.1

1.0.1.0 http://www.isset.nl

Sources Download

The Requires

by Felix Balfoort

08/03 2017

1.0.0

1.0.0.0 http://www.isset.nl

Sources Download

library push-notification

PushNotification is a push message abstraction which allows you to easily send push notifications to mobile devices. Currently we support Apple, Android and Windows (experimental)