ignited/laravel-sns-broadcaster

Sns Messages as queues using extended laravel sqs driver.

v1.1.1 2024-06-02 05:18 UTC

Requires

• php: >=7.4 <8.4
• ext-json: *
• aws/aws-sdk-php: ^3.305
• illuminate/broadcasting: ^8.0 || ^9.0 || ^10.0 || ^11.0
• illuminate/config: ^8.0 || ^9.0 || ^10.0 || ^11.0
• illuminate/contracts: ^8.0 || ^9.0 || ^10.0 || ^11.0
• illuminate/support: ^8.0 || ^9.0 || ^10.0 || ^11.0

MIT

• Alex Whiteside

• aws
• laravel
• SNS
• Broadcasting

README

(Original forked from maxgaurav/laravel-sns-broadcaster but this appears to be abandoned)

The package allows you to broadcast laravel events as sns topic.

The queue also processes standard jobs pushed via laravel.

This package is a great use cases for applications beings deployed to microservices.

Requirements

• PHP >= 7.4
• Laravel >= 8
• SNS in AWS

Installation

Install using composer

composer require ignited/laravel-sns-broadcaster

The package will automatically register its service provider.

Configuration

Driver setup

Update your .env use the broadcasting driver

BROADCAST_DRIVER=sns

Environment Setup

TOPIC_SUFFIX=-dev #leave it blank, if you are trying to deploy base

Broadcaster Configuration Setup

In config/broadcasting.php add the following driver setup

return [

    'null' => [
        'driver' => 'null',
     ],

    'sns' => [
        'driver' => 'sns',
        'region' => env('AWS_DEFAULT_REGION'),
        'key' => env('AWS_ACCESS_KEY_ID'),
        'secret' => env('AWS_SECRET_ACCESS_KEY'),
        'suffix' => env('TOPIC_SUFFIX', '-dev'),
        'arn-prefix' => env('TOPIC_ARN_PREFIX', 'arn:aws:sns:us-east-2:123345666:') // note the arn prefix contains colon
    
    ],
];

Event setup

In your events implement the ShouldBroadcast interface. Then set the topic name to be return through broadcastOn method.

use Illuminate\Contracts\Broadcasting\ShouldBroadcast;

class SampleEvent implements ShouldBroadcast
{

    /**
     * @inheritDoc
     */
    public function broadcastOn()
    {
        return "you-topic-name"; // the topic without the prefix and suffix. Example user-created. If -dev is suffix then it will automatically appended
    }
}

License

The MIT License.