README

用于与 RabbitMQ 服务器通信的 AMQP 扩展包装器。基于 php-amqplib/php-amqplib。

安装

安装此扩展的首选方式是通过 composer。

运行以下命令之一：

$ php composer.phar require webtoucher/yii2-amqp "*"

或

"webtoucher/yii2-amqp": "*"

将以下内容添加到您的 composer.json 文件的 require 部分：

在控制台配置中添加以下内容

return [
    ...
    'components' => [
        ...
        'amqp' => [
            'class' => 'webtoucher\amqp\components\Amqp',
            'host' => '127.0.0.1',
            'port' => 5672,
            'user' => 'your_login',
            'password' => 'your_password',
            'vhost' => '/',
        ],
        ...
    ],
    ...
    'controllerMap' => [
        ...
        'rabbit' => [
            'class' => 'webtoucher\amqp\controllers\AmqpListenerController',
            'interpreters' => [
                'my-exchange' => 'app\components\RabbitInterpreter', // interpreters for each exchange
            ],
            'exchange' => 'my-exchange', // default exchange
        ],
        ...
    ],
    ...
];

添加消息解释器类 @app/components/RabbitInterpreter 并设置不同路由键的处理程序

<?php

namespace app\components;

use webtoucher\amqp\components\AmqpInterpreter;


class RabbitInterpreter extends AmqpInterpreter
{
    /**
     * Interprets AMQP message with routing key 'hello_world'.
     *
     * @param array $message
     */
    public function readHelloWorld($message)
    {
        // todo: write message handler
        $this->log(print_r($message, true));
    }
}

用法

只需运行以下命令

$ php yii rabbit

以监听默认交换机上具有任何路由键的主题或

$ php yii rabbit my_routing_key

以监听具有单个路由键的主题。

运行以下命令

$ php yii rabbit my_routing_key direct --exchange=my_exchange

以监听所选交换机上的直接消息。

您还可以创建满足您需求的控制器。只需将您的 Web 控制器类 webtoucher\amqp\controllers\AmqpConsoleController 用于代替 yii\web\Controller，并将您的控制台控制器类 webtoucher\amqp\controllers\AmqpConsoleController 用于代替 yii\console\Controller。AMQP 连接将通过 connection 属性提供。AMQP 通道将通过 channel 属性提供。