Butter AMQP library for PHP, written purely in PHP



Butter AMQP

Build Status Scrutinizer Code Quality Code Coverage

Butter AMQP is a client library for AMQP protocol purely implemented in PHP. It has no dependencies on any PHP extension nor other PHP packages. It's very light-weight and lightning fast.

Butter AMQP supports all base AMQP features and RabbitMQ extensions, including: exchange to exchange bindings, publisher acknowledgments, negative acknowledgements and others.

Key features

  • Pure PHP implementation of AMQP protocol: no special requirements for PHP and easy upgrade using just composer
  • Easy to use functional API, it hides implementation details and reduce risk of making mistake
  • Code generator for frame encoding and decoding helps achieve high performance and low memory usage
  • Clean design makes it pleasure to work with AMQP, easy to tests and understand
  • Full support for AMQP protocol version 0.9.1 and RabbitMQ extensions


Easiest way to start using Butter AMQP library is to install it using composer. It has almost no dependencies and does not conflict with any other library.

Open a command console, enter your project directory and execute the following command to download the latest version of this library.

$ composer require skolodyazhnyy/butter-amqplib dev-master

This command requires you to have Composer installed globally, as explained in the installation chapter of the Composer documentation.


If you are new to AMQP, I suggest you have a look into RabbitMQ tutorial which explains all features of AMQP protocol in only 6 chapters tutorial! I have adopted it with code samples for Butter AMQP.

Every code snippet below extends previous one.

Connecting to the server

Establish connection to the server and open a channel.

use ButterAMQP\ConnectionBuilder;

$connection = ConnectionBuilder::make()

$channel = $connection->channel(1);

Read more

Define topology

Declare exchanges and queues.

use ButterAMQP\ExchangeInterface as Exchange;
use ButterAMQP\QueueInterface as Queue;

    ->define(Exchange::TYPE_FANOUT, Exchange::FLAG_DURABLE);
    ->define(Queue::FLAG_DURABLE | Queue::FLAG_EXCLUSIVE)

Read more

Publishing messages

Publish a message to newly declared exchange and it will be delivered to the queue.

use ButterAMQP\Message;

// Construct a message to be published
$message = new Message('hi there', ['content-type' => 'text/plain']);

// Publish message to default exchange, with routing key "text-messages".
$channel->publish($message, '', 'text-messages');

Read more

Consuming messages

Receive your message and acknowledge its delivery.

use ButterAMQP\Delivery;

// Declare consumer
$consumer = $channel->consume('text-messages', function(Delivery $delivery) {
    echo "Receive a message: " . $delivery->getBody() . PHP_EOL;
    // Acknowledge delivery

// Serve connection until consumer is cancelled
while($consumer->isActive()) {

Read more

Close connection

Properly closing connection to the server will guarantee all temporary queues will be deleted and resources released.

You don't need to close channels, just connection will be enough.


Known issues

  • Decimal type is not supported
  • Unsigned long long type is not supported