PHPackages                             nepster-web/php-simple-queue - 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. [Queues &amp; Workers](/categories/queues)
4. /
5. nepster-web/php-simple-queue

ActiveLibrary[Queues &amp; Workers](/categories/queues)

nepster-web/php-simple-queue
============================

Simple queues implementation in PHP through database.

1.0.0-Alpha-5(5y ago)193.1k1[1 issues](https://github.com/nepster-web/php-simple-queue/issues)MITPHPPHP ^7.4|^8.0

Since Feb 23Pushed 5y ago1 watchersCompare

[ Source](https://github.com/nepster-web/php-simple-queue)[ Packagist](https://packagist.org/packages/nepster-web/php-simple-queue)[ RSS](/packages/nepster-web-php-simple-queue/feed)WikiDiscussions master Synced today

READMEChangelog (5)Dependencies (7)Versions (8)Used By (0)

> This package is under development. Api classes of this application can be changed.

PHP Simple Queue
================

[](#php-simple-queue)

 [![Release](https://camo.githubusercontent.com/36c03daf00eb1b3d2c267a8eda162c211e2fc4ffbdb3703741b979897c037b5b/68747470733a2f2f736869656c64732e696f2f7061636b61676973742f762f6e6570737465722d7765622f7068702d73696d706c652d71756575652e7376673f696e636c7564655f70726572656c6561736573)](https://packagist.org/packages/nepster-web/php-simple-queue) [![Build](https://camo.githubusercontent.com/209872362ce5d8ec1ff552a8cf1cb11e4732312601f5a01c4b4f7bae1550d093/68747470733a2f2f7472617669732d63692e6f72672f6e6570737465722d7765622f7068702d73696d706c652d71756575652e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/github/nepster-web/php-simple-queue) [![Coverage](https://camo.githubusercontent.com/4626ae4a5c6a521b45ac4414ba0038933e1342f5ac2e4b5a0a76f96edd11572c/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f6e6570737465722d7765622f7068702d73696d706c652d71756575652f6261646765732f636f7665726167652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/nepster-web/php-simple-queue/?b=master) [![Downloads](https://camo.githubusercontent.com/f4a72975b5cdf77f8a1a2aaa1e8c060cfc0efa44edc92f9e48a362e0fd2bcd00/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6e6570737465722d7765622f7068702d73696d706c652d71756575652e737667)](https://packagist.org/packages/nepster-web/php-simple-queue) [![License](https://camo.githubusercontent.com/f3b7dcaee461790c66499d68774bfacf98e588ba1172ce73e92758da4f7f6a03/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6e6570737465722d7765622f7068702d73696d706c652d7175657565)](https://packagist.org/packages/nepster-web/php-simple-queue)

 [![Example of work](./docs/php-simple-queue-941x320.gif)](./docs/php-simple-queue-941x320.gif)

Introduction
------------

[](#introduction)

**PHP Simple Queue** - a library for running tasks asynchronously via queues. It is production ready, battle-tested a simple messaging solution for PHP.

It supports queues based on **DB**.

Requirements
------------

[](#requirements)

You'll need at least PHP 7.4 (it works best with PHP 8).

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

[](#installation)

The preferred way to install this extension is through [composer](http://getcomposer.org/download/):

Either run

```
php composer.phar require --prefer-dist nepster-web/php-simple-queue

```

or add

```
"nepster-web/php-simple-queue": "*"

```

💻 Basic Usage
-------------

[](#computer-basic-usage)

Create transport ([see more information](./docs/guide/transport.md)):

```
$transport = new \Simple\Queue\Transport\DoctrineDbalTransport($connection);
```

### Send a new message to queue (producing)

[](#send-a-new-message-to-queue-producing)

```
$config = \Simple\Queue\Config::getDefault()
    ->registerProcessor('my_queue', static function(\Simple\Queue\Context $context): string {
        // Your message handling logic
        return \Simple\Queue\Consumer::STATUS_ACK;
    });

$producer = new \Simple\Queue\Producer($transport, $config);

$message = $producer->createMessage('my_queue', ['key' => 'value']);

$producer->send($message);
```

### Job dispatching (producing)

[](#job-dispatching-producing)

```
$config = \Simple\Queue\Config::getDefault()
    ->registerJob(MyJob::class, new MyJob());

$producer = new \Simple\Queue\Producer($transport, $config);

$producer->dispatch(MyJob::class, ['key' => 'value']);
```

### Processing messages from queue (consuming)

[](#processing-messages-from-queue-consuming)

```
$producer = new \Simple\Queue\Producer($transport, $config);
$consumer = new \Simple\Queue\Consumer($transport, $producer, $config);

$consumer->consume();
```

For more details see the [example code](./example) and read the [guide](./docs/guide/example.md).

### Testing

[](#testing)

To run the tests locally, in the root directory execute below

```
./vendor/bin/phpunit

```

or you can run tests in a docker container

```
cd .docker
make build
make start
make composer cmd='test'

```

---

📖 Documentation
---------------

[](#book-documentation)

See [the official guide](./docs/guide/README.md).

📚 Resources
-----------

[](#books-resources)

- [Documentation](./docs/guide/README.md)
- [Example](./example)
- [Issue Tracker](https://github.com/nepster-web/php-simple-queue/issues)

📰 Changelog
-----------

[](#newspaper-changelog)

Detailed changes for each release are documented in the [CHANGELOG.md](./CHANGELOG.md).

🔒 License
---------

[](#lock-license)

See the [MIT License](LICENSE) file for license rights and limitations (MIT).

###  Health Score

29

—

LowBetter than 57% of packages

Maintenance19

Infrequent updates — may be unmaintained

Popularity28

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 66.3% 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 ~18 days

Total

5

Last Release

1882d ago

PHP version history (2 changes)1.0.0-AlphaPHP ~7.4 || ^8.0

1.0.0-Alpha-3PHP ^7.4|^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/b3afe1904e4ddaf0b5c2a46403167d059a74feec4a78644ba19a11eadb8f6bbe?d=identicon)[nepster-web](/maintainers/nepster-web)

---

Top Contributors

[![nepster-web](https://avatars.githubusercontent.com/u/5681979?v=4)](https://github.com/nepster-web "nepster-web (106 commits)")[![DenySolomakha](https://avatars.githubusercontent.com/u/47340854?v=4)](https://github.com/DenySolomakha "DenySolomakha (54 commits)")

---

Tags

phpqueueconsumerdatabase-queuesimple-queuedbal queue

###  Code Quality

TestsPHPUnit

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/nepster-web-php-simple-queue/health.svg)

```
[![Health](https://phpackages.com/badges/nepster-web-php-simple-queue/health.svg)](https://phpackages.com/packages/nepster-web-php-simple-queue)
```

###  Alternatives

[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.5k5.9M738](/packages/sylius-sylius)[shopware/platform

The Shopware e-commerce core

3.4k1.5M3](/packages/shopware-platform)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

585.6M574](/packages/shopware-core)[2lenet/crudit-bundle

The easy like Crud'it Bundle.

1616.4k14](/packages/2lenet-crudit-bundle)[neos/neos-development-collection

Neos packages in a joined repository for pull requests.

267103.9k1](/packages/neos-neos-development-collection)[open-dxp/opendxp

Content &amp; Product Management Framework (CMS/PIM)

9421.6k61](/packages/open-dxp-opendxp)

PHPackages © 2026

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