Skip to content

AMQP.md

Latest commit

 

History

History
125 lines (80 loc) · 3.43 KB

AMQP.md

File metadata and controls

125 lines (80 loc) · 3.43 KB
layout doc
title AMQP - Codeception - Documentation

This module interacts with message broker software that implements the Advanced Message Queuing Protocol (AMQP) standard. For example, RabbitMQ (tested). Use it to cleanup the queue between tests.

To use this module with Composer you need "videlalvaro/php-amqplib": "*" package.

Status

Please review the code of non-stable modules and provide patches if you have issues.

Config

  • host: localhost - host to connect
  • username: guest - username to connect
  • password: guest - password to connect
  • vhost: '/' - vhost to connect
  • cleanup: true - defined queues will be purged before running every test.
  • queues: [mail, twitter] - queues to cleanup

Example

modules:
    enabled:
        - AMQP:
            host: 'localhost'
            port: '5672'
            username: 'guest'
            password: 'guest'
            vhost: '/'
            queues: [queue1, queue2]

Public Properties

  • connection - AMQPStreamConnection - current connection

@since 1.1.2 @author tiger.seo@gmail.com @author davert

grabMessageFromQueue

Takes last message from queue.

$message = $I->grabMessageFromQueue('queue.emails');

  • param $queue
  • return AMQPMessage

pushToExchange

Sends message to exchange by sending exchange name, message and (optionally) a routing key

{% highlight php %}

pushToExchange('exchange.emails', 'thanks'); $I->pushToExchange('exchange.emails', new AMQPMessage('Thanks!')); $I->pushToExchange('exchange.emails', new AMQPMessage('Thanks!'), 'severity'); ?>

{% endhighlight %}

  • param $exchange
  • param $message string|AMQPMessage
  • param $routing_key

pushToQueue

Sends message to queue

{% highlight php %}

pushToQueue('queue.jobs', 'create user'); $I->pushToQueue('queue.jobs', new AMQPMessage('create')); ?>

{% endhighlight %}

  • param $queue
  • param $message string|AMQPMessage

seeMessageInQueueContainsText

Checks if message containing text received.

This method drops message from queue This method will wait for message. If none is sent the script will stuck.

{% highlight php %}

pushToQueue('queue.emails', 'Hello, davert'); $I->seeMessageInQueueContainsText('queue.emails','davert'); ?>

{% endhighlight %}

  • param $queue
  • param $text

 

Module reference is taken from the source code. Help us to improve documentation. Edit module reference