PHPackages                             sulu/messenger - 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. [API Development](/categories/api)
4. /
5. sulu/messenger

ActiveSulu-bundle[API Development](/categories/api)

sulu/messenger
==============

This library provides the stamps, middlewares and the sulu message bus.

1.0.0(4mo ago)9132.1k↓35.6%41MITPHPPHP 8.2.\* || 8.3.\* || 8.4.\* || 8.5.\*

Since Mar 10Pushed 4mo ago4 watchersCompare

[ Source](https://github.com/sulu/messenger)[ Packagist](https://packagist.org/packages/sulu/messenger)[ RSS](/packages/sulu-messenger/feed)WikiDiscussions main Synced 2d ago

READMEChangelog (10)Dependencies (33)Versions (17)Used By (1)

Sulu Messenger
==============

[](#sulu-messenger)

 [ ![Official Sulu Bundle Badge](https://camo.githubusercontent.com/8ac484ac60dbf97b4f747c6d0f704a16d2c005414d62dfcb2525b7c4cbf82466/68747470733a2f2f73756c752e696f2f75706c6f6164732f6d656469612f383030782f30302f3233302d4f6666696369616c25323042756e646c652532305365616c2e7376673f763d322d3626696e6c696e653d31) ](https://sulu.io/)

 [ ![GitHub license](https://camo.githubusercontent.com/3790db4464525283bd07335deddc21bb6d1b1875b68cf11f3f15025f72f39de5/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f73756c752f6d657373656e6765722e737667) ](LICENSE) [ ![GitHub tag (latest SemVer)](https://camo.githubusercontent.com/13fbe95f8eb7cc7e8994e28b4ae6979863b8cb2831d458fe517101a4dfbe62b2/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f7461672f73756c752f6d657373656e6765722e737667) ](https://github.com/sulu/messenger/releases) [ ![Test workflow status](https://camo.githubusercontent.com/63cb8f262750cdbf84dc7f31e0fa06ad8a76b8caed9310d1f338064a6ff91742/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f73756c752f6d657373656e6765722f746573742d6170706c69636174696f6e2e79616d6c) ](https://github.com/sulu/messenger/actions) [ ![Sulu compatibility](https://camo.githubusercontent.com/90a56b0395c28be216880d53f87f9c4ad379b6bdad189115e0561c508f899d2c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f73756c75253230636f6d7061746962696c6974792d2533453d322e302d3532623663612e737667) ](https://github.com/sulu/sulu/releases)

This library provides the stamps and middlewares which configures the Sulu message bus. It can be used independently in any Symfony installation.

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

[](#installation)

Make sure Composer is installed globally, as explained in the [installation chapter](https://getcomposer.org/doc/00-intro.md)of the Composer documentation.

Open a command console, enter your project directory and execute:

```
composer require sulu/messenger
```

Then, enable the bundle by adding it to the list of registered bundles in the `config/bundles.php` file of your project:

```
// config/bundles.php

return [
    // ...
    Sulu\Messenger\Infrastructure\Symfony\HttpKernel\SuluMessengerBundle::class => ['all' => true],
];
```

Middlewares
-----------

[](#middlewares)

### UnpackExceptionMiddleware

[](#unpackexceptionmiddleware)

The `UnpackExceptionMiddleware` will unpack the `HandlerFailedException` which is created by the Symfony [`HandleMessageMiddleware`](https://github.com/symfony/symfony/blob/c7dbcc954366f92f66360f3960a10dc1ef5f2584/src/Symfony/Component/Messenger/Middleware/HandleMessageMiddleware.php#L129). This way we make sure that the real exception is thrown out by this message bus, and a controller can catch or convert it to a specific http status code. This middleware is always activated in the Sulu message bus.

### LockMiddleware

[](#lockmiddleware)

The `LockMiddleware` will allow to lock specific resources by a given key. This is commonly used to prevent concurrent access to the same resource and avoid race conditions. The locking can be activated and controlled via the `LockStamp` which supports the same parameters as the Symfony `LockFactory` to create the Lock.

```
use Sulu\Messenger\Infrastructure\Symfony\Messenger\LockMiddleware\LockStamp;

$this->handle(new Envelope(new YourMessage(), [new LockStamp('lock-key')]));

# set ttl and autorelease
$this->handle(new Envelope(new YourMessage(), [new LockStamp('lock-key', 300.0, true)]));

# multiple locks possible all locks need to be acquired before processing the message
$this->handle(new Envelope(new YourMessage(), [new LockStamp('lock-key-1'), new LockStamp('lock-key-2')]));
```

This middleware is always activated in the Sulu message bus.

### DoctrineFlushMiddleware

[](#doctrineflushmiddleware)

The `DoctrineFlushMiddleware` is a Middleware which let us flush the Doctrine EntityManager by an opt-in flag via the `EnableFlushStamp`. It can be used this way:

```
use Sulu\Messenger\Infrastructure\Symfony\Messenger\FlushMiddleware\EnableFlushStamp;

$this->handle(new Envelope(new YourMessage(), [new EnableFlushStamp()]));
```

This middleware is always activated in the Sulu message bus.

###  Health Score

57

—

FairBetter than 98% of packages

Maintenance74

Regular maintenance activity

Popularity41

Moderate usage in the ecosystem

Community24

Small or concentrated contributor base

Maturity75

Established project with proven stability

 Bus Factor1

Top contributor holds 73.9% 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 ~110 days

Recently: every ~65 days

Total

14

Last Release

143d ago

Major Versions

0.2.11 → 1.0.02026-02-10

PHP version history (6 changes)0.1.0PHP 8.0.\* || 8.1.\*

0.2.1PHP 8.0.\* || 8.1.\* || 8.2.\*

0.2.3PHP 8.0.\* || 8.1.\* || 8.2.\* || 8.3.\*

0.2.5PHP 8.0.\* || 8.1.\* || 8.2.\* || 8.3.\* || 8.4.\*

0.2.9PHP 8.0.\* || 8.1.\* || 8.2.\* || 8.3.\* || 8.4.\* || 8.5.\*

1.0.0PHP 8.2.\* || 8.3.\* || 8.4.\* || 8.5.\*

### Community

Maintainers

![](https://www.gravatar.com/avatar/5dbafb2ec00aab7a9f476cf2dd77f63923acfda214ec7bf728c662a9e88f39c7?d=identicon)[chirimoya](/maintainers/chirimoya)

![](https://www.gravatar.com/avatar/e43a10984e8ee1687abaac86c26311c6a607b9560e8a3cc3193f8245751618bc?d=identicon)[wachterjohannes](/maintainers/wachterjohannes)

![](https://avatars.githubusercontent.com/u/1698337?v=4)[Alexander Schranz](/maintainers/alexander-schranz)[@alexander-schranz](https://github.com/alexander-schranz)

![](https://avatars.githubusercontent.com/u/25978473?v=4)[Prokyonn](/maintainers/Prokyonn)[@Prokyonn](https://github.com/Prokyonn)

---

Top Contributors

[![alexander-schranz](https://avatars.githubusercontent.com/u/1698337?v=4)](https://github.com/alexander-schranz "alexander-schranz (17 commits)")[![mamazu](https://avatars.githubusercontent.com/u/14860264?v=4)](https://github.com/mamazu "mamazu (2 commits)")[![mario-fehr](https://avatars.githubusercontent.com/u/14167832?v=4)](https://github.com/mario-fehr "mario-fehr (2 commits)")[![benr77](https://avatars.githubusercontent.com/u/2156742?v=4)](https://github.com/benr77 "benr77 (1 commits)")[![Prokyonn](https://avatars.githubusercontent.com/u/25978473?v=4)](https://github.com/Prokyonn "Prokyonn (1 commits)")

---

Tags

commandbusmessagebusmessengersymfonysymfony-bundle

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan, Rector

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/sulu-messenger/health.svg)

```
[![Health](https://phpackages.com/badges/sulu-messenger/health.svg)](https://phpackages.com/packages/sulu-messenger)
```

###  Alternatives

[easycorp/easyadmin-bundle

Admin generator for Symfony applications

4.3k17.9M388](/packages/easycorp-easyadmin-bundle)[sylius/sylius

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

8.5k5.9M737](/packages/sylius-sylius)[open-dxp/opendxp

Content & Product Management Framework (CMS/PIM)

9421.6k61](/packages/open-dxp-opendxp)[oro/platform

Business Application Platform (BAP)

645143.5k115](/packages/oro-platform)[contao/core-bundle

Contao Open Source CMS

1231.6M2.8k](/packages/contao-core-bundle)[pimcore/pimcore

Content & Product Management Framework (CMS/PIM/E-Commerce)

3.8k3.8M507](/packages/pimcore-pimcore)

PHPackages © 2026

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