Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/JoggApp/laravel-aws-sns
Laravel package for the AWS SNS Events
https://github.com/JoggApp/laravel-aws-sns
aws aws-sns laravel laravel-aws-sns laravel-package package
Last synced: about 2 months ago
JSON representation
Laravel package for the AWS SNS Events
- Host: GitHub
- URL: https://github.com/JoggApp/laravel-aws-sns
- Owner: JoggApp
- License: mit
- Created: 2019-11-18T11:31:37.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2024-03-13T08:01:37.000Z (6 months ago)
- Last Synced: 2024-04-24T18:55:42.490Z (5 months ago)
- Topics: aws, aws-sns, laravel, laravel-aws-sns, laravel-package, package
- Language: PHP
- Homepage:
- Size: 15.6 KB
- Stars: 30
- Watchers: 3
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Laravel package for the AWS SNS Events
[](https://github.com/JoggApp/laravel-aws-sns/releases)
[](https://packagist.org/packages/JoggApp/laravel-aws-sns)
Amazon Simple Notification Service (Amazon SNS) is a web service that coordinates and manages the delivery or sending of messages to subscribing endpoints or clients. The Amazon S3 notification feature enables you to receive notifications when certain events happen in your bucket.
This package ships with a controller that listens to the SNS notification incoming to one of your defined URL/endpoint. The controller takes care of validating the incoming request's signature & messages, confirming your endpoint's subscription to the SNS topic and also emits respective Laravel events. If you are using AWS SNS, all you have to do after installing this package is add your desired Laravel Listeners. The Listeners will automatically receive the SNS message. You are free to take control of the message after that to achieve your desired results.
## Installation and Usage
- You can install this package via composer using this command:
```bash
composer require joggapp/laravel-aws-sns
```
- The package will automatically register itself.
- You then need to pass the route to `awsSnsWebhooks`:
```php
Route::awsSnsWebhooks('route-you-added-in-aws-sns-topic-subscription-console');
```
- The package emits 2 events: `SnsTopicSubscriptionConfirmed` & `SnsMessageReceived`.
- `SnsTopicSubscriptionConfirmed`: This event is fired once the endpoint's subscription to the SNS topic is confirmed.
- `SnsMessageReceived`: This event is fired everytime your endpoint receives a message (request) from AWS SNS.
- To use these events you will have to add the events in your `app/Providers/EventServiceProvider.php`
- You can access the SNS message in your listeners listening to the `SnsMessageReceived` event just like you would do in any other laravel listener:
```php
class SnsListener
{
public function handle($event)
{
$event->message
}
}
```
## Changelog
Please see the [CHANGELOG](CHANGELOG.md) for more information about what has changed recently.
## Security
If you discover any security related issues, please email them to [[email protected]](mailto:[email protected]) instead of using the issue tracker.
## Credits
- [Harish Toshniwal](https://github.com/introwit)
- [All Contributors](../../contributors)
## License
The MIT License (MIT). Please see the [License File](LICENSE.txt) for more information.