gidix/pushnotifier-php

PushNotifier library for PHP

PushNotifier (v2) for PHP

A pretty convenient library to use PushNotifier in PHP projects., _(*1)

Installation

Add this to composer.json:, _(*2)

"require": {
    "gidix/pushnotifier-php": "^2.0.0"
}

...or run composer require gidix/pushnotifier-php, _(*3)

Usage

You only have to use one class: GIDIX\PushNotifier\SDK\PushNotifier. Everything is derived from there., _(*4)

Creating your Application

Before you can actually do anything, you have to create your application. It consists of an API Token and a package name. Both can be configured at pushnotifier.de/account/api., _(*5)

Then you can create your instance:, _(*6)

    $app = new GIDIX\PushNotifier\SDK\PushNotifier([
        'api_token'     =>  'YOUR_API_TOKEN',
        'package'       =>  'YOUR.PACKAGE.NAME'
    ]);

Login

When authenticating as a user you have to log them in, then use their AppToken for all further communication:, _(*7)

    $appToken = $app->login('username', 'password');

You can store $appToken anywhere you like by converting it to a string before storing (see examples/storing-app-token.php)., _(*8)

Afterwards you can use the AppToken to authenticate:, _(*9)

    $app = new GIDIX\PushNotifier\SDK\PushNotifier([
        'api_token'     =>  'YOUR_API_TOKEN',
        'package'       =>  'YOUR.PACKAGE.NAME',
        'app_token'     =>  $appToken
    ]);

Retrieving Devices

    $devices = $app->getDevices();

will retrieve an array of GIDIX\PushNotifier\SDK\Device objects, containing an ID, a title, a model and a link to an image of the device. Device IDs do not change over time and serve as a unique identifier., _(*10)

Sending Texts

    $result = $app->sendMessage($devices, 'Some Content');

$devices has to be an array of either Device objecs or device ID strings, i.e. ['abc', 'xyz']., _(*11)

Sending URLs

    $result = $app->sendURL($devices, 'https://some.example.org/with/path.html');

$devices has to be an array of either Device objecs or device ID strings, i.e. ['abc', 'xyz']., _(*12)

Sending Notifications

    $result = $app->sendNotification($devices, 'Some Content', 'https://some.example.org/with/path.html');

Exceptions

• DeviceNotFoundException: When a device couldn't be found
• InvalidAPITokenException: When the api_token or package couldn't be verified
• InvalidAppTokenException: When the AppToken couldn't be verified or has expired
• InvalidCredentialsException: When login credentials were incorrect
• InvalidRequestException: When some request data was malformatted, i.e. malformatted URL for notifications
• PushNotifierException: Base Exception for all these, only thrown in case of an unknown error (500)

$devices has to be an array of either Device objecs or device ID strings, i.e. ['abc', 'xyz']., _(*13)

Examples

Examples can be found in examples/ of this repository., _(*14)