PHP操作RabbitMQ的类 exchange、queue、route kye、bind

RabbitMQ是常见的消息中间件。也许是还是不够了解的缘故，感觉功能还好吧。

讲到队列，大家脑子里第一印象是下边这样的。

P生产者推送消息-->队列-->C消费者取出消息

结构很简单，但是RabbitMQ应该是为了丰富的功能吧，把“队列”拆分了。

分成了：exchange（交换机）和queue（队列）两个部分

同时说明：

生产者推送消息只推到exchange，不知道会进入哪个queue。

exchange通过一个route key与queue绑定，这时才会知道消息具体落到了哪个queue里。

而消费则获取消息，是直接从队列里取的。

大概就是以上这个意思，问题是还有两个特殊的说明：

1.消费者是无法订阅或者获取不存在的MessageQueue中信息。

2.消息被Exchange接受以后，如果没有匹配的Queue，则会被丢弃。

简单的理解就是，如果exchange和queue不绑定，生产者推送的消息到exchange会直接丢弃（丢失），同时consume也无法完成订阅。

所以，这里就有一个问题，无论是推送消息进队列，还是订阅消息消费，必须先定义好exchange和queue并通过route key绑定一起。

那么到底是推送消息的时候定义并绑定呢？还是订阅的时候定义并绑定呢？

根据那两个特殊的说明理解，无论是谁定义绑定，都有可能会出现问题。

所以，最终就是推送和消费之前，都尝试定义exchange和queue，并完成绑定。

推送消息，相对简单，就一个publish指定exchange和route key就完成了。

消费消息，相对的复杂一点，有两种方式：

1、推送（push）订阅方式，使用consume方法订阅队列，只要队列有消息就消费

2、拉取（poll）主动拉取，使用get方法，主动去从队列一次拉取一条消息

这两种情况，都有各自的应用场景，可以根据需要自行选择。

额外提醒一点：尽量不要使用循环的方式调用get方法消费队列，尤其是处理的消息很多的情况。

如果大量的消费队列，建议直接使用consume方法。

还有一个情况，当消费者取出消息时，可以不对消息队列做任何操作，也可以将取出的消息删除。

毕竟，队列里的消息，消费后是需要删除的，取到消息，发给队列一个然亏，队列就删除该消息。

这个取出消息后的删除，也分两种情况：

1、一种是取出就删除，consume和get两个方法都有一个参数AMQP_AUTOACK自动反馈

2、另一种是取出后，并不会自动返回删除，而是将取出来的消息处理之后确认没有问题了，手动反馈给消息队列

至于选择哪种反馈方式，根据需求自行选择。

关于RabbitMQ还有很多要说的，比如一个exchange可以绑定多个queue，多个exchange可以绑定一个queue（多对多的关系）

还可以根据exchange不同的模式，搭配不同的route key做不同的匹配。各种组合吧。

灵活应用起来功能还是很强大的，只是具体使用时需要仔细，因为一个不小心，不是丢失消息就是多出很多消息。

所知有限，在此不做特复杂的说明，下边的例子也是一个简单的完成一个简单的队列的操作。演示学习用。

更多的情况，就自行研究扩展。

RabbitMQ操作类（rabbitmq.class.php）

<?php
// rabbitmq 操作类
class RabbitMQ
{
    // 配置变量
    public $configs = array(
        'host' => 'localhost', 
        'port' => '5672', 
        'login' => 'guest', 
        'password' => 'guest',
        'vhost' => '/'
    );
    public $exchange_name = 'ex_q_def';// 交换机名称
    public $queue_name = 'ex_q_def';// 队列名称
    public $route_key = '';// 路由key的名称
    public $durable = true;// 持久化，默认true
    public $autodelete = false;// 自动删除

    // 内部通用变量
    private $_conn = null;
    private $_exchange = null;
    private $_channel = null;
    private $_queue = null;

    // 构造函数
    public function __construct()
    {
        // 初始化队列
        $this->init();
    }

    // 配置rabbitmq
    public function set_configs($configs)
    {
        // 初始化配置
        if (!is_array($configs)) {
            echo 'configs is not array.';
        }
        if (!($configs['host'] && $configs['port'] && $configs['login'] && $configs['password'])) {
            echo 'configs is empty.';
        }
        if (!isset($configs['vhost'])) {// 没有vhost元素，给出默认值
            $configs['vhost'] = '/';
        } else {
            if (empty($configs['vhost'])) {// 有vhost元素，但是值为空，给出默认值
                $configs['vhost'] = '/';
            }
        }
        $this->configs = $configs;
    }

    // 初始化rabbitmq
    private function init()
    {
        if (!$this->_conn) {
            $this->_conn = new AMQPConnection($this->configs);// 创建连接对象
            if (!$this->_conn->connect()) {
                echo "Cannot connect to the broker 
 ";
                exit(0);
            }
        }

        // 创建channel
        $this->_channel = new AMQPChannel($this->_conn);
    }

    // 创建队列（为了保证正常订阅，避免消息丢失，生产者和消费则都要尝试创建队列：交换机和队列通过路由绑定一起）
    public function create_queue($exchange_name='', $route_key='', $queue_name='')
    {
        if ($exchange_name != '') {
            // 队列名参数可以省略，默认与交换机同名
            $this->exchange_name = $exchange_name;// 更新交换机名称
            $this->queue_name = $exchange_name;// 更新队列名称
        }
        if ($route_key != '') $this->route_key = $route_key;// 更新路由
        if ($queue_name != '') $this->queue_name = $queue_name;// 独立更新队列名称

        // 创建exchange交换机
        $this->_exchange = new AMQPExchange($this->_channel);// 创建交换机
        $this->_exchange->setType(AMQP_EX_TYPE_DIRECT);// 设置交换机模式为direct
        if ($this->durable) {
            $this->_exchange->setFlags(AMQP_DURABLE);// 设置是否持久化
        }
        if ($this->autodelete) {
            $this->_exchange->setFlags(AMQP_AUTODELETE);// 设置是否自动删除
        }
        $this->_exchange->setName($this->exchange_name);// 设置交换机名称
        $this->_exchange->declare();

        // 创建queue队列
        $this->_queue = new AMQPQueue($this->_channel);
        if ($this->durable) {
            $this->_queue->setFlags(AMQP_DURABLE);// 设置是否持久化
        }
        if ($this->autodelete) {
            $this->_queue->setFlags(AMQP_AUTODELETE);// 设置是否自动删除
        }
        $this->_queue->setName($this->queue_name);// 设置队列名称
        $this->_queue->declare();// 完成队列的定义

        // 将queue和exchange通过route_key绑定在一起
        $this->_queue->bind($this->exchange_name, $this->route_key);
    }

    // 生产者，向队列交换机发送消息
    public function send($msg, $exchange_name='', $route_key='', $queue_name='')
    {
        $this->create_queue($exchange_name, $route_key, $queue_name);// 创建exchange和queue根据route_key绑定一起
        // 消息处理
        if (is_array($msg)) {
            $msg = json_encode($msg);// 将数组类型转换成JSON格式
        } else {
            $msg = trim(strval($msg));// 简单处理一下要发送的消息内容
        }

        // 生产者推送消息进队列时，只能将消息推送到交换机exchange中
        if ($this->durable) {
            $this->_exchange->publish($msg, $this->route_key, AMQP_NOPARAM, array('delivery_mode'=>2));// delivery_mode 2持久化 1非持久化;AMQP_NOPARAM表示无参数
        } else {
            $this->_exchange->publish($msg, $this->route_key);
        }
    }

    // 消费者，从队列中获取数，消费队列（订阅）
    public function run($fun_name, $exchange_name='', $route_key='', $queue_name='', $autoack=false)
    {
        if (!$fun_name) return false;// 没有返回函数，或者队列不存在
        $this->create_queue($exchange_name, $route_key, $queue_name);
        // 订阅消息
        while (true) {
            if ($autoack) {
                $this->_queue->consume($fun_name, AMQP_AUTOACK);// 自动应答
            } else {
                $this->_queue->consume($fun_name);// 需要手动应答
            }
        }
    }

    // 消费者，从队列中获取数，消费队列（主动获取）
    public function get($exchange_name='', $route_key='', $queue_name='', $autoack=false)
    {
        $this->create_queue($exchange_name, $route_key, $queue_name);
        // 主动获取消息
        if ($autoack) {
            $msg = $this->_queue->get(AMQP_AUTOACK);// 自动应答
        } else {
            $msg = $this->_queue->get();// 需要手动应答
        }
        return ['msg'=>$msg, 'queue'=>$this->_queue];
    }
}
?>

生产者推送（test_send.php）

<?php
require_once('rabbitmq.class.php');

$rmq = new RabbitMQ;
for ($i = 0; $i < 10; $i++) {
    echo 'test_consume_' . $i .'<br />';
    $rmq->send('test_consume_' . $i, 'test_consume');
}

for ($i = 0; $i < 10; $i++) {
    echo 'get_msg_'.$i.'<br />';
    $rmq->send('get_msg_' . $i, 'test_get');
}

echo 'send ok ! ' . date('Y-m-d H:i:s');
?>

消费者consume（test_run.php）

<?php
require_once('rabbitmq.class.php');

$rmq = new RabbitMQ;

$s = $rmq->run('processMessage', 'test_consume');

function processMessage($envelope, $queue) {
    $msg = $envelope->getBody();
    sleep(1);  //sleep1秒模拟任务处理
    echo $msg."
"; //处理消息
    $queue->ack($envelope->getDeliveryTag()); //手动发送ACK应答
}
?>

消费者get（test_get.php）

<?php
require_once('rabbitmq.class.php');

$rmq = new RabbitMQ;

$r = $rmq->get('test_get');

echo $r['msg']->getBody();// 取到的消息
$r['queue']->ack($r['msg']->getDeliveryTag());// 手动反馈，删除消费的消息
?>

订阅consume可以起多个程序，队列会轮询平均的分到每一个订阅里。当然，前提是处理速度是一样，并且都有反馈。

如果处理速度不同，哪个快 ，哪就会分配更多的消息。如果没有反馈，默认只会推送3条消息，如果一直不给反馈，就不会再有推送了。

此时如果中断这个没有反馈的订阅，因为队列中没有删除，会再次分配到其他订阅者哪里继续推送消费。

同样的，如果队列中有消息，随时开启新的订阅，随时就会分配到消费的消息。