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' => 'rooooodik\amqp\components\Amqp',
            'host' => '127.0.0.1',
            'port' => 5672,
            'user' => 'your_login',
            'password' => 'your_password',
            'vhost' => '/',
        ],
        ...
    ],
    ...
    'controllerMap' => [
        ...
        'rabbit' => [
            'class' => 'rooooodik\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 rooooodik\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

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

运行以下命令

$ php yii rabbit my_routing_key direct  --noAck=true

以启用自动确认。

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