PHPackages                             mehr-it/lara-sqs-plain - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. mehr-it/lara-sqs-plain

ActiveLibrary

mehr-it/lara-sqs-plain
======================

Receive custom/plain SQS messages in Laravel

2.4.0(4y ago)0187[1 PRs](https://github.com/mehr-it/lara-sqs-plain/pulls)MITPHPPHP >=7.0.0

Since Jan 3Pushed 2y agoCompare

[ Source](https://github.com/mehr-it/lara-sqs-plain)[ Packagist](https://packagist.org/packages/mehr-it/lara-sqs-plain)[ RSS](/packages/mehr-it-lara-sqs-plain/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (5)Versions (8)Used By (0)

lara-sqs-plain
==============

[](#lara-sqs-plain)

Allows to receive custom/plain SQS messages in Laravel. This is very useful if you have to work with third party messages not dispatched from Laravel.

You receive the plain message content in the constructor of your handler classes. You may specify your own handler class for each queue.

This package is based on the [mehr-it/lara-sqs-ext](https://github.com/mehr-it/lara-sqs-ext)package and implements most of it's features.

Installation
------------

[](#installation)

```
composer require mehr-it/lara-sqs-plain

```

This package uses Laravel's package auto-discovery, so the service provider will be loaded automatically.

Queue configuration
-------------------

[](#queue-configuration)

Just configure a queue connection as you would configure any other SQS queue in Laravel. The only difference is the `message_handler` option, which must be the name of the class which should handle the messages:

```
'sqs-plain-conn' => [
	'driver'          => 'sqs-plain',
	'key'             => '112233445566778899',
	'secret'          => 'xxxxxxxxxxxxxxxxxxxxxxxxxx',
	'prefix'          => 'https://sqs.eu-central-1.amazonaws.com/11223344556677',
	'queue'           => 'msgs',
	'region'          => 'eu-central-1',
	'message_handler' => 'App\\Job\\MyPlainHandler',
],

```

### Long polling

[](#long-polling)

To enable long polling, you may add the option `message_wait_timeout` to the queue configuration. This sets the `WaitTimeSeconds` parameter to the configured amount of time.

```
'message_wait_timeout' => 20,

```

Message handlers
----------------

[](#message-handlers)

To create a handler for SQS messages, simply extend the `SqsPlainMessageHandler` class. The `handle` function will be invoked for each message and the raw message body will be available in the `message` attribute:

```
class MyPlainHandler extends SqsPlainMessageHandler {

	public function handle() {

		$rawMessage = $this->message;
	}

}

```

The `InteractsWithQueue` and `InteractsWithSqsQueue` trait is already implemented in the base class, so you can interact with the queue.

Message handlers my define the same properties as common jobs, to control the job workers. This includes `tries`, `timeout`, `timeoutAt`, `automaticQueueVisibility`, `automaticQueueVisibilityExtra` or the `retryUntil` method.

Thanks
------

[](#thanks)

Thanks to Jussi Hamalainen who wrote the `jusahah/laravel-sqs-jobless` package which served as guideline for this package.

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity60

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~227 days

Recently: every ~284 days

Total

6

Last Release

1547d ago

Major Versions

1.0.0 → 2.0.02019-01-05

PHP version history (2 changes)1.0.0PHP >=5.6.0

2.1.0PHP >=7.0.0

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/44973729?v=4)[mehr.IT GmbH](/maintainers/mehr-it)[@mehr-it](https://github.com/mehr-it)

---

Top Contributors

[![chmgr](https://avatars.githubusercontent.com/u/94837732?v=4)](https://github.com/chmgr "chmgr (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/mehr-it-lara-sqs-plain/health.svg)

```
[![Health](https://phpackages.com/badges/mehr-it-lara-sqs-plain/health.svg)](https://phpackages.com/packages/mehr-it-lara-sqs-plain)
```

###  Alternatives

[anourvalar/eloquent-serialize

Laravel Query Builder (Eloquent) serialization

11320.2M21](/packages/anourvalar-eloquent-serialize)[georgeboot/laravel-echo-api-gateway

Use Laravel Echo with API Gateway Websockets

10435.5k](/packages/georgeboot-laravel-echo-api-gateway)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)