davibennun / laravel-push-notification by davibennun

Laravel package to send push notifications to mobile devices (apns, gcm)
Package Data
Maintainer Username: davibennun
Maintainer Contact: davi@andradenunes.org (DaviBenNun)
Package Create Date: 2014-01-07
Package Last Update: 2020-02-19
Language: PHP
License: Unknown
Last Refreshed: 2022-06-30 15:17:55
Package Statistics
Total Downloads: 1,108,353
Monthly Downloads: 7,839
Daily Downloads: 468
Total Stars: 1,227
Total Watchers: 53
Total Forks: 254
Total Open Issues: 114

Laravel Push Notification

Package to enable sending push notifications to devices


Update your composer.json file to include this package as a dependency

Laravel 5 & Lumen

"davibennun/laravel-push-notification": "dev-laravel5"

Laravel 4.*

"davibennun/laravel-push-notification": "dev-master"

Register the PushNotification service provider by adding it to the providers array.

'providers' => array(

Alias the PushNotification facade by adding it to the aliases array in the app/config/app.php file.

'aliases' => array(
	'PushNotification' => 'Davibennun\LaravelPushNotification\Facades\PushNotification'


Copy the config file into your project by running: (Lumen users skip this)

Laravel 5

php artisan vendor:publish --provider="Davibennun\LaravelPushNotification\LaravelPushNotificationServiceProvider" --tag="config"

Laravel 4.*

php artisan config:publish davibennun/laravel-push-notification

This will generate a config file like this

		'environment' => 'development',
		'certificate' => '/path/to/certificate.pem',
		'passPhrase'  => 'password',
		'service'     => 'apns'
		'environment' => 'production',
		'apiKey'      => 'yourAPIKey',
		'service'     => 'gcm'

Where all first level keys corresponds to an service configuration, each service has its own properties, android for instance have apiKey and IOS uses certificate and passPhrase. You can set as many services configurations as you want, one for each app.

Dont forget to set service key to identify IOS 'service'=>'apns' and Android 'service'=>'gcm'
The certificate path must be an absolute path, so in the configuration file you can use these:
//Path to the 'app' folder

Laravel functions are also available public_path() storage_path() base_path()


                ->send('Hello World, i`m a push message');

Where app argument appNameIOS refers to defined service in config file.

Dynamic configuration and Lumen users

You can set the app config array directly: (keep in mind the array schema)

//iOS app
PushNotification::app(['environment' => 'development',
		'certificate' => '/path/to/certificate.pem',
		'passPhrase'  => 'password',
		'service'     => 'apns']);
//Android app		
PushNotification::app(['environment' => 'production',
		'apiKey'      => 'yourAPIKey',
		'service'     => 'gcm']);

To multiple devices and optioned message:

$devices = PushNotification::DeviceCollection(array(
    PushNotification::Device('token', array('badge' => 5)),
    PushNotification::Device('token1', array('badge' => 1)),
$message = PushNotification::Message('Message Text',array(
    'badge' => 1,
    'sound' => 'example.aiff',
    'actionLocKey' => 'Action button title!',
    'locKey' => 'localized key',
    'locArgs' => array(
        'localized args',
        'localized args',
    'launchImage' => 'image.jpg',
    'custom' => array('custom data' => array(
        'we' => 'want', 'send to app'

$collection = PushNotification::app('appNameIOS')

// get response for each device push
foreach ($collection->pushManager as $push) {
    $response = $push->getAdapter()->getResponse();

// access to adapter for advanced settings
$push = PushNotification::app('appNameAndroid');
$push->adapter->setAdapterParameters(['sslverifypeer' => false]);

This package is wrapps Notification Package and adds some flavor to it.

Usage advice

This package should be used with Laravel Queues, so pushes dont blocks the user and are processed in the background, meaning a better flow.