README

为Laravel（或Lumen）提供的自定义SQS连接器，支持自定义格式的JSON和XML有效负载。默认情况下，Laravel期望SQS消息以特定格式生成 - 该格式包括作业处理类和序列化的作业。

但在某些情况下，您可能需要解析来自第三方应用程序的消息，自定义JSON消息等。

依赖关系

PHP >= 5.5
Laravel（或Lumen）>= 5.2

通过Composer安装

要安装，只需运行

composer require keithbrink/laravel-plain-sqs

Lumen中的使用

// Add in your bootstrap/app.php
$app->loadComponent('queue', 'Suleymanozev\PlainSqs\LumenServiceProvider');

配置

// Generate standard config file (Laravel only)
php artisan vendor:publish --provider="Suleymanozev\PlainSqs\LaravelServiceProvider"

// In Lumen, create it manually (see example below) and load it in bootstrap/app.php
$app->configure('sqs-plain');

编辑config/sqs-plain.php以满足您的需求。此配置将SQS队列与处理类匹配。

return [
    'handlers' => [
        'base-integrations-updates' => App\Jobs\HandlerJob::class,
    ],

    'default-handler' => App\Jobs\HandlerJob::class
];

如果队列未在'handlers'数组中找到，则将SQS有效负载传递给默认处理程序。

将sqs-plain连接添加到您的config/queue.php中，例如

        ...
        'sqs-plain' => [
            'driver' => 'sqs-plain',
            'key'    => env('AWS_KEY', ''),
            'secret' => env('AWS_SECRET', ''),
            'prefix' => 'https://sqs.ap-southeast-2.amazonaws.com/123123/',
            'queue'  => 'important-music-updates',
            'region' => 'ap-southeast-2',
        ],
        ...

在您的.env文件中，选择sqs-plain作为您的新默认队列驱动程序

QUEUE_DRIVER=sqs-plain

向SQS发送

如果您计划从Laravel或Lumen推送普通消息，则可以依赖DispatcherJob

use Suleymanozev\PlainSqs\Jobs\DispatcherJob;

class ExampleController extends Controller
{
    public function index()
    {
        // Create a PHP object
        $object = [
            'music' => 'M.I.A. - Bad girls',
            'time' => time()
        ];

        // Pass it to dispatcher job
        $job = new DispatcherJob($object);

        // Dispatch the job as you normally would
        // By default, your data will be encapsulated in 'data' and 'job' field will be added
        $this->dispatch($job);

        // If you wish to submit a true plain JSON, add setPlain()
        $this->dispatch($job->setPlain());
    }
}

这将向SQS推送以下JSON对象

{"job":"App\\Jobs\\HandlerJob@handle","data":{"music":"M.I.A. - Bad girls","time":1462511642}}

'job'字段实际上未使用。它仅保留以兼容性为目的。

从SQS接收

如果第三方应用程序正在创建自定义格式的JSON消息，只需在配置文件中添加处理程序，并实现以下处理程序类

use Illuminate\Contracts\Queue\Job as LaravelJob;

class HandlerJob extends Job
{
    protected $data;

    /**
     * @param LaravelJob $job
     * @param array $data
     */
    public function handle(LaravelJob $job, array $data)
    {
        // This is incoming JSON payload, already decoded to an array
        var_dump($data);

        // Raw JSON payload from SQS, if necessary
        var_dump($job->getRawBody());
    }
}

待办事项

添加更多单元和集成测试

许可证

在此条件下，免费许可任何人复制此软件及其关联文档（“软件”）的副本，并允许在不限制的情况下处理软件，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或出售软件的副本，并允许将软件提供给任何收到软件的人，以便他们执行此类操作

软件按“原样”提供，不提供任何明示或暗示的保证，包括但不限于对适销性、针对特定目的的适用性和非侵权的保证。在任何情况下，作者或版权持有人均不对任何索赔、损害或其他责任负责，无论该索赔、损害或其他责任是基于合同、侵权或其他方式产生的，是否与软件或其使用或其他交易有关。

致谢

此软件包是从https://github.com/dusterio/laravel-plain-sqs分叉的

suleymanozev / laravel-plain-sqs

维护者

详细信息