PHPackages                             assegaiphp/rabbitmq - 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 & Workers](/categories/queues)
4. /
5. assegaiphp/rabbitmq

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

assegaiphp/rabbitmq
===================

RabbitMQ queue integration for AssegaiPHP framework, providing decorators and tools for producing and consuming AMQP-based jobs.

1.0.1(2mo ago)02MITPHPPHP >=8.4CI passing

Since Jul 15Pushed 2mo agoCompare

[ Source](https://github.com/assegaiphp/rabbitmq)[ Packagist](https://packagist.org/packages/assegaiphp/rabbitmq)[ RSS](/packages/assegaiphp-rabbitmq/feed)WikiDiscussions main Synced today

READMEChangelog (2)Dependencies (5)Versions (5)Used By (0)

 [![Assegai Logo](https://camo.githubusercontent.com/d7dab2658d76e460e31be249de2fe5d420f7a7237eb9f2a315f83123632a3b6c/68747470733a2f2f617373656761697068702e636f6d2f696d616765732f6c6f676f732f6c6f676f2d63726f707065642e706e67)](https://assegaiphp.com/)

 [![Latest release](https://camo.githubusercontent.com/724d4333a1ea04e9f9c8b2c465f4861b00e8eda3faee870e9b18d7c673257f3a/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f617373656761697068702f7261626269746d713f646973706c61795f6e616d653d74616726736f72743d73656d766572267374796c653d666c61742d737175617265)](https://github.com/assegaiphp/rabbitmq/releases) [![Tests](https://camo.githubusercontent.com/1a4d0d84a484d7650f4cadc6b677e10c89efa137d832c326dff8fa60a27495b7/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f617373656761697068702f7261626269746d712f7068702e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/assegaiphp/rabbitmq/actions/workflows/php.yml) [![PHP 8.4+](https://camo.githubusercontent.com/51482859d8bb7cd31d259f58cf02b8eb7e56c51ad36c462afa3484f3b7a8fc2c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e342532422d3737374242343f7374796c653d666c61742d737175617265266c6f676f3d706870266c6f676f436f6c6f723d7768697465)](https://camo.githubusercontent.com/51482859d8bb7cd31d259f58cf02b8eb7e56c51ad36c462afa3484f3b7a8fc2c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e342532422d3737374242343f7374796c653d666c61742d737175617265266c6f676f3d706870266c6f676f436f6c6f723d7768697465) [![License](https://camo.githubusercontent.com/c4ff84deb9aa0d4c838cbcce97821cb503ac322b700105ba20a8523e3f435933/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f617373656761697068702f7261626269746d713f7374796c653d666c61742d737175617265)](https://github.com/assegaiphp/rabbitmq/blob/main/LICENSE) [![Status active](https://camo.githubusercontent.com/1214b36790042a591c22d285a8cbfdc3c33d1cbbbed099a0bca2f5edd79ca2a0/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7374617475732d6163746976652d3130623938313f7374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/1214b36790042a591c22d285a8cbfdc3c33d1cbbbed099a0bca2f5edd79ca2a0/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7374617475732d6163746976652d3130623938313f7374796c653d666c61742d737175617265)

RabbitMQ queue driver for AssegaiPHP applications.

AssegaiPHP RabbitMQ Queue Integration
=====================================

[](#assegaiphp-rabbitmq-queue-integration)

This package provides **RabbitMQ queue support** for the [AssegaiPHP](https://assegaiphp.com/) framework. It enables asynchronous job handling using AMQP through PhpAmqpLib.

---

Contribution workflow
---------------------

[](#contribution-workflow)

For commit and pull request conventions in this repo, see:

- [docs/commit-and-pr-guidelines.md](./docs/commit-and-pr-guidelines.md)

---

📦 Installation
--------------

[](#-installation)

Install via Composer:

```
composer require assegaiphp/rabbitmq
```

### RabbitMQ extension requirement

[](#rabbitmq-extension-requirement)

This package currently requires the PHP `amqp` extension.

If Composer stops with an error like this:

```
Root composer.json requires PHP extension ext-amqp * but it is missing from your system.

```

the problem is usually your local PHP CLI setup, not RabbitMQ itself.

Check the PHP environment Composer is using:

```
php --ini
php -m | grep amqp
```

If `amqp` is missing, install or enable it for the same PHP version that runs Composer.

On Debian or Ubuntu, that is often:

```
sudo apt install php-amqp
```

or a version-specific package such as:

```
sudo apt install php8.5-amqp
```

If your distribution does not provide a package yet, `pecl` is often the fallback:

```
sudo pecl install amqp
```

After that, confirm the extension is loaded with `php -m | grep amqp` and rerun Composer.

Avoid installing with `--ignore-platform-req=ext-amqp` for normal development. That bypasses Composer's check, but it does not make the extension available at runtime.

---

⚙️ Configuration
----------------

[](#️-configuration)

Update your application's `config/queues.php` file to register the RabbitMQ driver and define your connections:

```