Install this package with Composer:
composer require laravel-notification-channels/aws-sns
After installing the package, register the ServiceProvider with your config/app.php.
NotificationChannels\AwsSns\SNSServiceProvider::class
You will need to obtain required API access key and secret key from AWS console. Also, you need to define the region that you are using for SNS.
AWS_ACCESS_KEY_ID
AWS_SECRET_ACCESS_KEY
AWS_REGION (default = us-east-1)
If you need to override other settings for AWS API access, please refer to configuration section of official AWS PHP Laravel Service Provider which this package depends on.
In order to send notifications via SNS, you need to create a notification class. If you want to send message to a specific endpoint, you need to provide TargetArn. If you want to send to a topic, then provide TopicArn. A simple example is as follow:
use Illuminate\Notifications\Notification;
use NotificationChannels\AwsSns\SNSMessage;
use NotificationChannels\AwsSns\SNSChannel;
use NotificationChannels\AwsSns\Notifications\APNS;
use NotificationChannels\AwsSns\Notifications\GCM;
use NotificationChannels\AwsSns\Notifications\SMS;
class AccountApproved extends Notification
{
public function via($notifiable)
{
return [SNSChannel::class];
}
public function toSNS($notifiable)
{
return (new SNSMessage)
->message('This is a simple message')
->subject('This is subject')
->topicArn('<YourTopicArn>');
}
}
SNS support custom messages for specific endpoints. Therefore, you can setup a custom message for various platforms. For instance, you can configure a custom GCM push notification that will be send to the subscribers of the topic that are registered via GCM. Currently, APNS, GCM, and SMS are implemented. Other endpoints that are supported by AWS will be added later.
public function toSNS($notifiable)
{
return (new SNSMessage())
->message('This is a custom message')
->subject('This is subject')
->messageStructure('json')
->topicArn('<TopicArn>')
->apnsMessage((new APNS)
->message('APNS custom message')
->badge(2)
->sound('sound.mp3')
->addCustomPayload('custom1', 'test value 1')
->addCustomPayload('custom2', 'test value 2'))
->gcmMessage((new GCM)
->message('GCM custom message'))
->smsMessage(new SMS('SMS custom message'));
}
subeject(): Subject of the notification.message(): Default message of the notification.topicArn(): Topic that notification will be send to.targetArn(): A specific target ARN, if you want to send notification to a specific subscriber.messageStructure(): If you want to use custom notifications for different endpoints, then you need to set message structure to'json'messageAttributes(): Custom attributes supported by AWS SNS.phoneNumber(): If you want to send SMS, set phone number.apnsMessage(): Custom APNS message.gcmMessage(): Custom GCM message.smsMessage(): Custom SMS message.
message(): APNS custom message.badge(): App icon badge count.sound(): Alert message sound.addCustomPayload(): Custom payload for notification.
message(): GCM custom message.data(): Data payload.notification(): Notification payload.priority(): Notification priority.collapseKey(): Notification collapse key.timeToLive(): Notification time to live duration.
message(): SMS custom message.
For further details of each method, please refer to SNS PHP SDK.
Please see CHANGELOG for more information what has changed recently.
$ composer testIf you discover any security related issues, please email [email protected] instead of using the issue tracker.
Please see CONTRIBUTING for details.
The MIT License (MIT). Please see License File for more information.