gustavorglima/laravel-json-sqs

There is no license information available for the latest version (v1.0.3) of this package.

Laravel 5 SQS connector that uses JSON to transmit messages

v1.0.3 2018-04-18 12:13 UTC

Requires

• php: >=5.5.0
• aws/aws-sdk-php: ~3.0
• illuminate/bus: 5.*
• illuminate/queue: 5.*
• illuminate/support: 5.*

Unknown License

• Gustavo Lima

• json
• aws
• laravel
• sqs

README

Dependencies

• PHP >= 5.5
• Laravel >= 5.4

Installation

First of all you need to require the package using composer:

composer require gustavorglima/laravel-json-sqs

Configuration

Now open config/app.php to add the provider:

'providers' => [
    ...
    GustavoLima\JsonSQS\LaravelServiceProvider::class,
];

Publish config/json-sqs.php

php artisan vendor:publish --provider="GustavoLima\JsonSQS\LaravelServiceProvider"

Create failed table:

php artisan queue:failed-table

Create json-sqs connection on config/queue.php:

'json-sqs' => [
    'driver' => 'json-sqs',
    'key' => env('SQS_KEY'),
    'secret' => env('SQS_SECRET'),
    'prefix' => env('SQS_PREFIX'),
    'queue' => env('SQS_QUEUE'),
    'region' => env('SQS_REGION'),
],

Set queue driver on .env

QUEUE_DRIVER=json-sqs

And configure your credentials (Example):

SQS_KEY=ABCDEFGHIJKLMN
SQS_SECRET=abCDEFghiJKlmNOpqRStuVWXyzabCDEFghiJK
SQS_PREFIX=https://sqs.us-east-1.amazonaws.com/1234567890
SQS_QUEUE=sqs-queue-name
SQS_REGION=us-east-1

Creating a Job

To read published messages on SQS Queue we need to create a Job:

php artisan make:job TestJob

You handle method must be like that:

public function handle(Job $job, $data)
{
    dd($data); // Just to debug received message
}

Open config/json-sqs.php and add:

'test-job' => App\Jobs\TestJob::class,

Publishing a message

To publish a message it's pretty simple, you just need to pass the job name that was specified in config/json-sqs.php and the data, example:

dispatch(
    new Dispatcher('test-job', [
        'some' => 'data'
    ])
);

Start the worker

php artisan queue:work json-sqs --tries=3

Obs. In production we recommend to use Supervisor.