发布/订阅

在上篇教程中,我们搭建了一个工作队列。每个任务之分发给一个工作者(worker)。在本篇教程中,我们要做的之前完全不一样——分发一个消息给多个消费者(consumers)。这种模式被称为“发布/订阅”。

为了描述这种模式,我们将会构建一个简单的日志系统。它包括两个程序——第一个程序负责发送日志消息,第二个程序负责获取消息并输出内容。

在我们的这个日志系统中,所有正在运行的接收方程序都会接受消息。我们用其中一个接收者(receiver)把日志写入硬盘中,另外一个接受者(receiver)把日志输出到屏幕上。

最终,日志消息被广播给所有的接受者(receivers)。

交换器(Exchanges)

前面的教程,我们发送消息到队列并从中取出消息。现在是时候介绍 RabbitMq 中完整的消息模型了。

让我们简单的概括一下之前的教程:

  • *发布者(producer)*是发布消息的应用程序。
  • *队列(queue)*用于消息存储的缓冲。
  • *消费者(consumer)*是接收消息的应用程序。

RabbitMQ 消息模型的核心理念是:发布者(producer)不会直接发送任何消息给队列。事实上,发布者(producer)甚至不知道消息是否已经被投递到队列。

发布者(producer)只需要把消息发送给一个*交换器(exchange)*。交换器非常简单,它一边从发布者方接收消息,一边把消息推入队列。交换器必须知道如何处理它接收到的消息,是应该推送到指定的队列还是是多个队列,或者是直接忽略消息。这些规则是通过*exchange type*来定义的。

有几个可供选择的交换器类型:AMQP_EX_TYPE_DIRECT, AMQP_EX_TYPE_FANOUT,AMQP_EX_TYPE_HEADER or AMQP_EX_TYPE_TOPIC。我们在这里主要说明AMQP_EX_TYPE_FANOUT。先创建一个 fanout 类型的交换器,命名为 logs:

$exchange->setName('logs');
$exchange->setType(AMQP_EX_TYPE_FANOUT);
$exchange->declare();

fanout 交换器很简单,你可能从名字上就能猜测出来,它把消息发送给它所知道的所有队列。这正是我们的日志系统所需要的。

交换器列表

rabbitmqctl 能够列出服务器上所有的交换器:

> $ sudo rabbitmqctl list_exchanges
> Listing exchanges ...
> logs      fanout
> amq.direct      direct
> amq.topic       topic
> amq.fanout      fanout
> amq.headers     headers
> ...done.
> ```
>
> 这个列表中有一些叫做 amq.\*的交换器。这些都是默认创建的,不过这时候你还不需要使用他们。
>
> #### 匿名的交换器
>
> ~~前面的教程中我们对交换器一无所知,但仍然能够发送消息到队列中。因为我们使用了命名为空字符串(“”)默认的交换器。~~
>
> ~~回想我们之前是如何发布一则消息:~~
>
> ```
> $exchange->publish($message, $routeKey);
> ```
>
> ~~exchange 参数就是交换器的名称。空字符串代表默认或者匿名交换器:消息将会根据指定的 routing_key 分发到指定的队列。~~
>
> **在 PHP 的 AMQP 中如果 exchange 设置为匿名的话,是报错的:PHP Fatal error: Uncaught exception ‘AMQPExchangeException’ with message ‘Invalid exchange name given, must be between 1 and 255 characters long.’**

现在,我们就可以发送消息到一个具名交换器了:

```php
$exchange->publish($message, '');

临时队列

你还记得之前我们使用的队列名吗( hello 和 task_queue)?给一个队列命名是很重要的——我们需要把工作者(workers)指向正确的队列。如果你打算在发布者(producers)和消费者(consumers)之间共享同队列的话,给队列命名是十分重要的。

但是这并不适用于我们的日志系统。我们打算接收所有的日志消息,而不仅仅是一小部分。我们关心的是最新的消息而不是旧的。为了解决这个问题,我们需要做两件事情。

首先,当我们连接上 RabbitMQ 的时候,我们需要一个全新的、空的队列。我们可以手动创建一个随机的队列名,或者让服务器为我们选择一个随机的队列名(推荐)。我们只要在调用$queue->declare();方法的时候,不提供 queue 参数就可以了:

$queue = new AMQPQueue($channel);
$queue->setFlags(AMQP_EXCLUSIVE);
$queue->declare();

这时候我们可以通过$queue->getName();获得已经生成的随机队列名。它可能是这样子的:amq.gen-U0srCoW8TsaXjNh73pnVAw==。

第二步,当与消费者(consumer)断开连接的时候,这个队列应当被删除。我们可以使用 exclusive 标识。

$queue->setFlags(AMQP_EXCLUSIVE);

绑定(Bindings)

我们已经创建了一个 fanout 类型的交换器和一个队列。现在我们需要告诉交换器如何发送消息给我们的队列。交换器和队列之间的关系我们称之为*绑定(binding)*。

$queue->bind($exchangeName, $queue->getName());

现在,logs 交换器将会把消息添加到我们的队列中。

绑定列表。

你可以使用 rabbitmqctl list_bindings 队列出所有存在的绑定。.

整合

发布日志消息的程序看起来和之前的没有太大区别。最重要的改变就是我们把消息发送给 logs 交换器而不是匿名交换器。在发送的时候我们需要提供 routing_key 参数,但是它的值会被 fanout 交换器忽略。以下是 emit_log.php 脚本:

<?php

/**
 * PHP amqp(RabbitMQ) Demo-3
 * @author  yuansir <yuansir@live.cn/yuanxuxu.com>
 */

$exchangeName = 'logs';
$message = empty($argv[1]) ? 'info:Hello World!' : ' '.$argv[1];

$connection = new AMQPConnection(array('host' => '127.0.0.1', 'port' => '5672', 'vhost' => '/', 'login' => 'guest', 'password' => 'guest'));
$connection->connect() or die("Cannot connect to the broker!\n");

$channel = new AMQPChannel($connection);
$exchange = new AMQPExchange($channel);
$exchange->setName($exchangeName);
$exchange->setType(AMQP_EX_TYPE_FANOUT);
$exchange->declare();

$exchange->publish($message, '');
var_dump("[x] Sent $message");

$connection->disconnect();

正如你看到的那样,在连接成功之后,我们声明了一个交换器,这一个是很重要的,因为不允许发布消息到不存在的交换器。

如果没有绑定队列到交换器,消息将会丢失。但这个没有所谓,如果没有消费者监听,那么消息就会被忽略。

receive_logs.php 的代码:

<?php

/**
 * PHP amqp(RabbitMQ) Demo-3
 * @author  yuansir <yuansir@live.cn/yuanxuxu.com>
 */
$exchangeName = 'logs';

$connection = new AMQPConnection(array('host' => '127.0.0.1', 'port' => '5672', 'vhost' => '/', 'login' => 'guest', 'password' => 'guest'));
$connection->connect() or die("Cannot connect to the broker!\n");
$channel = new AMQPChannel($connection);
$exchange = new AMQPExchange($channel);
$exchange->setName($exchangeName);
$exchange->setType(AMQP_EX_TYPE_FANOUT);
$exchange->declare();
$queue = new AMQPQueue($channel);
$queue->setFlags(AMQP_EXCLUSIVE);
$queue->declare();
$queue->bind($exchangeName, '');

var_dump('[*] Waiting for messages. To exit press CTRL+C');
while (TRUE) {
        $queue->consume('callback');
}
$connection->disconnect();

function callback($envelope, $queue) {
        $msg = $envelope->getBody();
        var_dump(" [x] Received:" . $msg);
        $queue->nack($envelope->getDeliveryTag());
}

这样我们就完成了。如果你想把日志保存到文件中,只需要打开控制台输入:

$ php receive_logs.php > logs_from_rabbit.log

如果你想在屏幕中查看日志,那么打开一个新的终端然后运行:

$ php receive_logs.php

当然还要发送日志:

$ php emit_log.php

使用 rabbitmqctl list_bindings 你可确认已经创建了队列的绑定。你可以看到运行中的两个 receive_logs.php 程序:

$ sudo rabbitmqctl list_bindings
Listing bindings ...
 ...
logs    amq.gen-TJWkez28YpImbWdRKMa8sg==                []
logs    amq.gen-x0kymA4yPzAT6BoC/YP+zw==                []
...done.

显示结果很直观:logs 交换器把数据发送给两个系统命名的队列。这就是我们所期望的。

如何监听消息的子集呢?让我们移步教程 4

转载请注明: 转载自Ryan 是菜鸟 | LNMP 技术栈笔记

如果觉得本篇文章对您十分有益,何不 打赏一下

谢谢打赏

本文链接地址: RabbitMQ 官方中文入门教程(PHP 版) 第三部分:发布/订阅(Publish/Subscribe)

知识共享许可协议 本作品采用知识共享署名-非商业性使用 4.0 国际许可协议进行许可