redu/sns-push

API Wrapper for Amazon SNS PHP SDK

SNS Push (for AWS SNS API)

This package provides a bunch of helper methods to aid interacting with the Amazon (AWS) SNS API., _(*1)

, _(*2)

SNS Push is a simple SNS SDK wrapper with a collection of methods to aid in interacting with the AWS SNS API. It works directly with Laravel or can be used as a standalone PHP package., _(*3)

Prerequisites

Installing

You need to use Composer to install SNS Push into your project:, _(*4)

composer require redu/sns-push

Configuring (Laravel)

Now you have to include SNSPushServiceProvider in your config/app.php:, _(*5)

'providers' => [
    /*
     * Package Service Providers...
     */
    SNSPush\SNSPushServiceProvider::class,
]

Add 'sns' config keys to the config/services.php, _(*6)

'sns' => [
    'account_id' => env('SNS_ACCOUNT_ID', ''),
    'access_key' => env('SNS_ACCESS_KEY', ''),
    'secret_key' => env('SNS_SECRET_KEY', ''),
    'scheme' => env('SNS_SCHEME', 'https'),
    'region' => env('SNS_REGION', 'eu-west-1'),
    'platform_applications' => [
        'ios' => '<application-endpoint-arn>',
        'android' => '<application-endpoint-arn>'
    ]
],

Other PHP Framework (not Laravel) Setup

You should include the Composer autoload.php file if not already loaded:, _(*7)

require __DIR__ . '/vendor/autoload.php';
 ```

Instantiate the SNSPush class with the following required config values: 
- account_id
- access_key
- secret_key
- platform_applications

Also configurable:
- region [default: eu-west-1]
- api_version [default: 2010-03-31]
- scheme [default: https]
```php
$sns = new SNSPush([
    'account_id' => '<aws-account-id>', // Required
    'access_key' => '<aws-iam-user-access-key>', // Required 
    'secret_key' => '<aws-iam-user-secret-key>', // Required
    'scheme' => 'http', // Defaults to https
    'platform_applications' => [ // Required
        'ios' => '...',
        'android' => '...'
    ]
]);

Add Device to Application

Add a device to a platform application (ios/android) by passing the device token and application key to addDevice()., _(*8)

$sns->addDevice('<device-token>, 'ios');

Remove Device from Application

Remove a device from AWS SNS by passing the Endpoint ARN to removeDevice()., _(*9)

$sns->removeDevice('<endpoint-arn>');

Subscribe Device to Topic

Subscribe a device to a Topic by passing the Endpoint Arn and Topic Arn to subscribeDeviceToTopic()., _(*10)

$sns->subscribeDeviceToTopic('<endpoint-arn>', '<topic-arn>');

Remove Device from Topic

Remove a device from a Topic by passing the Subscription Arn to removeDeviceFromTopic()., _(*11)

$sns->removeDeviceFromTopic('<subscription-arn>');

Sending Push Notifications

SNS Push supports sending notifications to both Topic Endpoint or directly to an Endpoint ARN (Device)., _(*12)

Send to Device

$message = 'Push notification message.';

$sns->sendPushNotificationToDevice(
    '<endpoint-arn>', 
    $message
);

You can also optionally send a custom payload along with the message., _(*13)

$sns->sendPushNotificationToDevice('<endpoint-arn>', $message, [
    'payload' => [
        'id' => 9
    ]
]);

The message structure is sent as JSON and will be properly formatted per device. This is a requirement if sending to multiple platforms and/or sending a custom payload., _(*14)

If you are only sending a simple message to a single platform and would like to save on bytes you can set the message structure to a string., _(*15)

$sns->sendPushNotificationToDevice('<endpoint-arn>', $message, [
    'message_structure' => 'string'
]);

Send to Topic

$message = 'Push notification message.';

$sns->send->sendPushNotificationToTopic(
    '<topic-arn>', 
    $message
);

Similarly, you can set the message structure and payload., _(*16)

To do

• Support more endpoints
• Test, test, test... (still in early development, use with caution)

Licence

MIT License © Redu Group Ltd, _(*17)