Send Push Notification in Laravel
The alexlisenkov/laravel-web-push package is a package to send push notifications.
Send out push messages as a standalone package. Use this if you dont work with laravel notification channels.
If you are new to the Web Push Protocol please read about the fundamentals.
Installation
composer require alexlisenkov/laravel-web-pushphp artisan vendor:publish --provider="AlexLisenkov\LaravelWebPush\LaravelWebPushServiceProvider"Configuration
To send out Web Push notifications you need to generate yourself an identity. The simplest thing to do is to visit https://web-push-codelab.glitch.me
Open up config/laravel-web-push.php
Copy the public key and private key into your configuration. Please note that this public key is the same as you will use in the applicationServerKey in the JavaScript pushManager api.
<?php
/*
* To generate a application server keys
* Visit: https://web-push-codelab.glitch.me/
*/
return [
'public_key' => '',
'private_key' => '',
'subject' => config('APP_URL', 'mailto:[email protected]'),
'expiration' => 43200,
'TTL' => 2419200,
];Sending a Web Push
Quick guide
A message can be created by creating a new AlexLisenkov\LaravelWebPush\PushMessage class.
Please see this MDN doc or the Living Standards to see all available options.
<?php
namespace App\Http\Controllers;
use Illuminate\Http\Response;
use AlexLisenkov\LaravelWebPush\PushMessage;
use AlexLisenkov\LaravelWebPush\PushSubscription;
class PushMessageController
{
public function sendPushMessage(): Response
{
// Create a subscription
$subscription = new PushSubscription(
"endpoint",
"p256dh",
"auth"
);
// Create a message
$message = new PushMessage();
$message->setTitle('Hello World');
$message->setBody('This message is sent using web push');
$message->setIcon('https://placekitten.com/75/75');
// We can either use the message to send it to a subscription
$message->sendTo($subscription)->wait();
// Or send the subscription a message
$subscription->sendMessage($message)->wait();
return response('ok');
}
}Creating message objects
A message can be created by creating a new class that extends the AlexLisenkov\LaravelWebPush\PushMessage class.
Please see this MDN doc or the Living Standards to see all available options.
<?php
namespace App\Http\Controllers;
use AlexLisenkov\LaravelWebPush\PushMessage;
class ExampleMessage extends PushMessage
{
protected $title = 'Hello world';
protected $body = 'This message is sent using web push';
protected $icon = 'https://placekitten.com/75/75';
// Or override a getter
public function getData()
{
return User()->name;
}
}Creating a subscription
The AlexLisenkov\LaravelWebPush\PushSubscription is used to create a new subscription.
<?php
use AlexLisenkov\LaravelWebPush\PushSubscription;
new PushSubscription(
"endpoint",
"p256dh",
"auth"
);It is also possible for you to implement AlexLisenlov\LaravelWebPush\Contracts\PushSubscriptionContract into any class.
For example on a model.
Sending a notification
Now that we have a subscriber and a message, we can send it out.
<?php
use AlexLisenkov\LaravelWebPush\PushSubscription;
// Create a new message
$message = new ExampleMessage();
// Create a new subscription
$subscription = new PushSubscription(
"endpoint",
"p256dh",
"auth"
);
// We can either use the message to send it to a subscription
$message->sendTo($subscription);
// Or send the subscription a message
$subscription->sendMessage($message);Service worker
Show a notification to the subscriber by adding an event listener in your service worker.
self.addEventListener('push', function(e) {
let data = e.data.json();
self.registration.showNotification(data.title, data.options);
});Testing
$ composer testSecurity
If you discover any security related issues, please email [email protected] instead of using the issue tracker.
Contributing
Contributions are welcome.
- PSR-2 coding standards
- Keep the project tested
- Keep your pull requests small and limited
Credits
License
The MIT License (MIT). Please see License File for more information.