How to install BunnyPHP with Composer?

Run 'composer require bunny/bunny:@^0.6dev' to install the latest development version. Ensure you have PHP 8.1 or newer, as specified in the requirements.

BunnyPHP vs php-amqplib which should I use?

Choose BunnyPHP for better performance and a cleaner API, especially if you need async support with ReactPHP. Opt for php-amqplib if you prioritize a more established, stable library with wider community adoption, despite its slower speed.

How to set up TLS/SSL connections with BunnyPHP?

Pass a 'tls' array in the Configuration with options like 'cafile' and 'local_cert', or use a DSN with query parameters. Invalid TLS configs cause connection failures, so refer to the README's TLS examples for details.

Can BunnyPHP work with ActiveMQ or other message brokers?

No, BunnyPHP only supports AMQP 0.9.1, which is specific to RabbitMQ. ActiveMQ uses AMQP 1.0, a completely different protocol, making BunnyPHP incompatible, as noted in the broker compatibility section.

What PHP version do I need for BunnyPHP?

BunnyPHP requires PHP 8.1 or newer, leveraging modern features like Fibers for async operations. Older PHP versions are unsupported, so upgrade if necessary.

How do I consume messages asynchronously in BunnyPHP?

Wrap the consume callback in an async function using ReactPHP's Loop and fibers, as shown in the README's full examples. You must run all channel methods inside a fiber to avoid errors.

Is BunnyPHP ready for production use?

The README states it's used in production but isn't marked stable (v0.6 dev). Proceed with caution if you need guaranteed stability, as breaking changes might occur before a 1.0 release.

Open-Awesome

BunnyPHP

MITPHPv0.5.6

A performant pure-PHP AMQP client for RabbitMQ with synchronous and asynchronous (ReactPHP) support.

GitHub

749 stars105 forks0 contributors

What is BunnyPHP?

BunnyPHP is a pure-PHP AMQP client library for connecting to RabbitMQ message brokers. It provides high-performance message publishing and consuming capabilities with support for both synchronous and asynchronous programming patterns using ReactPHP. The library solves the problem of needing a performant, extension-free way to work with RabbitMQ in PHP applications.

Target Audience

PHP developers building applications that need to integrate with RabbitMQ message queues, particularly those who can't or don't want to install PECL extensions, or who need both synchronous and asynchronous operation modes.

Value Proposition

Developers choose BunnyPHP for its superior performance compared to php-amqplib, its pure-PHP implementation that avoids PECL extension dependencies, and its clean, idiomatic API that follows PHP standards. The dual sync/async support makes it versatile for different application architectures.

Overview

Performant pure-PHP AMQP (RabbitMQ) sync/async (ReactPHP) library

Use Cases

Best For

PHP applications requiring high-performance RabbitMQ integration
Projects that cannot install PECL extensions on their servers
ReactPHP-based asynchronous applications needing AMQP support
Microservices architectures using message queues for communication
Applications needing both synchronous and asynchronous message processing
Teams wanting clean, idiomatic PHP APIs for AMQP operations

Not Ideal For

Projects using message brokers other than RabbitMQ that require AMQP 1.0, like ActiveMQ
Teams stuck on legacy PHP versions below 8.1 due to infrastructure constraints
Enterprises needing vendor-supported, stable libraries with long-term compatibility guarantees
Simple CLI scripts where the overhead of ReactPHP and fibers for async operations is unjustified

Pros & Cons

Pros

Extension-Free Deployment

Pure PHP implementation eliminates the need for PECL extensions like ext-amqp, making it deployable on any standard PHP installation without additional dependencies.

Benchmark-Beating Performance

Outperforms php-amqplib by up to 366% in message production and 949% in consumption, as shown in detailed benchmarks in the README, rivaling ext-amqp in many tests.

Sync and Async Flexibility

Supports both synchronous patterns and asynchronous operation via ReactPHP integration with Fibers, allowing seamless use in traditional and event-driven PHP applications.

Clean PHP-Centric API

Follows PHP coding standards with idiomatic naming and modern features like named parameters, avoiding the awkward interfaces found in alternatives like php-amqplib.

Cons

Pre-1.0 Stability Concerns

The library is still in development (v0.6 dev) and not marked stable, which could pose risks for production systems needing long-term support and backward compatibility.

Async Mode Complexity

Asynchronous usage requires wrapping calls in fibers and managing ReactPHP event loops, adding setup overhead and a learning curve compared to simpler synchronous clients.

Limited Broker Compatibility

Only implements AMQP 0.9.1 for RabbitMQ, making it incompatible with brokers using AMQP 1.0 or other protocols, as admitted in the README's broker compatibility section.

Frequently Asked Questions

Related Projects

PHP AMQP

The most widely used PHP client for RabbitMQ

Stars4,602

Forks1,024

Last commit8 days ago

Enqueue

Message Queue, Job Queue, Broadcasting, WebSockets packages for PHP, Symfony, Laravel, Magento. DEVELOPMENT REPOSITORY - provided by Forma-Pro

Stars2,220

Forks428

Last commit1 month ago

Pheanstalk

PHP client for beanstalkd queue

Stars1,920

Forks281