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.
composer require alexlisenkov/laravel-web-pushphp artisan vendor:publish --provider="AlexLisenkov\LaravelWebPush\LaravelWebPushServiceProvider"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,
];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');
}
}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;
}
}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.
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);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);
});$ composer testIf you discover any security related issues, please email [email protected] instead of using the issue tracker.
Contributions are welcome.
- PSR-2 coding standards
- Keep the project tested
- Keep your pull requests small and limited
The MIT License (MIT). Please see License File for more information.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent