digiaonline/lumen-sns-middleware

Collection of middleware and helpers for dealing with AWS SNS notifications

lumen-sns-middleware

, _(*1)

This library contains a collection of middleware and helpers for dealing with AWS SNS notifications., _(*2)

Features

• a middleware for validating the signatures of SNS notifications
• middleware for transparently handling subscription and unsubscribe confirmations
• a factory for creating SNS Message objects from HttpFoundation request objects (which Lumen uses)
• a basic enum class for notification types

Requirements

• PHP >= 7.0
• Lumen >= 5.5

Installation

Add the library as a dependency:, _(*3)

composer require digiaonline/lumen-sns-middleware 

Register the service provider:, _(*4)

$app->register(Digia\Lumen\SnsMiddleware\Providers\SnsMiddlewareServiceProvider::class);

Usage

Apply any of the following middleware to your routes:, _(*5)

• MessageValidatorMiddleware - validates requests and throws an exception they don't contain a valid SNS message
• HandleSubscriptionConfirmationMiddleware - automatically confirms SubscriptionConfirmation messages
• HandleUnsubscribeConfirmationMiddleware - automatically confirms UnsubscribeConfirmation messages

Using a custom HTTP client

If for some reason you need to use a custom HTTP client when validating messages or confirming subscription/unsubscribe messages, bind an implementation of HttpClientInterface to your container, e.g.:, _(*6)

$app->bind(HttpClientInterface::class, MyImplementation::class);

License

MIT, _(*7)

Testing

Run composer test, _(*8)