2013年6月13日星期四

RabbitMQ官方中文入门教程(PHP版) 第三部分:发布／订阅（Publish/Subscribe）

发布／订阅

在上篇教程中，我们搭建了一个工作队列。每个任务之分发给一个工作者（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 orAMQP_EX_TYPE_TOPIC。我们在这里主要说明AMQP_EX_TYPE_FANOUT。先创建一个fanout类型的交换器，命名为logs：
1$exchange->setName('logs');
2$exchange->setType(AMQP_EX_TYPE_FANOUT);
3$exchange->declare();
fanout交换器很简单，你可能从名字上就能猜测出来，它把消息发送给它所知道的所有队列。这正是我们的日志系统所需要的。

交换器列表

rabbitmqctl能够列出服务器上所有的交换器：
1$ sudo rabbitmqctl list_exchanges
2Listing exchanges ...
3logs      fanout
4amq.direct      direct
5amq.topic       topic
6amq.fanout      fanout
7amq.headers     headers
8...done.
这个列表中有一些叫做amq.*的交换器。这些都是默认创建的，不过这时候你还不需要使用他们。

匿名的交换器

前面的教程中我们对交换器一无所知，但仍然能够发送消息到队列中。因为我们使用了命名为空字符串(“”)默认的交换器。
回想我们之前是如何发布一则消息：
1$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.’
现在，我们就可以发送消息到一个具名交换器了：
1$exchange->publish($message, '');

临时队列

你还记得之前我们使用的队列名吗（ hello和task_queue）？给一个队列命名是很重要的——我们需要把工作者（workers）指向正确的队列。如果你打算在发布者（producers）和消费者（consumers）之间共享同队列的话，给队列命名是十分重要的。
但是这并不适用于我们的日志系统。我们打算接收所有的日志消息，而不仅仅是一小部分。我们关心的是最新的消息而不是旧的。为了解决这个问题，我们需要做两件事情。
首先，当我们连接上RabbitMQ的时候，我们需要一个全新的、空的队列。我们可以手动创建一个随机的队列名，或者让服务器为我们选择一个随机的队列名（推荐）。我们只要在调用$queue->declare();方法的时候，不提供queue参数就可以了：
1$queue = new AMQPQueue($channel);
2$queue->setFlags(AMQP_EXCLUSIVE);
3$queue->declare();
这时候我们可以通过$queue->getName();获得已经生成的随机队列名。它可能是这样子的：amq.gen-U0srCoW8TsaXjNh73pnVAw==。
第二步，当与消费者（consumer）断开连接的时候，这个队列应当被删除。我们可以使用exclusive标识。
1$queue->setFlags(AMQP_EXCLUSIVE);

绑定（Bindings）

我们已经创建了一个fanout类型的交换器和一个队列。现在我们需要告诉交换器如何发送消息给我们的队列。交换器和队列之间的关系我们称之为绑定（binding）。
1$queue->bind($exchangeName, $queue->getName());
现在，logs交换器将会把消息添加到我们的队列中。

绑定列表。

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

整合

发布日志消息的程序看起来和之前的没有太大区别。最重要的改变就是我们把消息发送给logs交换器而不是匿名交换器。在发送的时候我们需要提供routing_key参数，但是它的值会被fanout交换器忽略。以下是emit_log.php脚本：
01<?php
02 
03/**
04 * PHP amqp(RabbitMQ) Demo-3
05 * @author  yuansir <yuansir@live.cn/yuansir-web.com>
06 */
07 
08$exchangeName = 'logs';
09$message = empty($argv[1]) ? 'info:Hello World!' : ' '.$argv[1];
10 
11$connection = new AMQPConnection(array('host' => '127.0.0.1', 'port' => '5672', 'vhost' => '/', 'login' => 'guest', 'password' => 'guest'));
12$connection->connect() or die("Cannot connect to the broker!\n");
13 
14$channel = new AMQPChannel($connection);
15$exchange = new AMQPExchange($channel);
16$exchange->setName($exchangeName);
17$exchange->setType(AMQP_EX_TYPE_FANOUT);
18$exchange->declare();
19 
20$exchange->publish($message, '');
21var_dump("[x] Sent $message");
22 
23$connection->disconnect();
正如你看到的那样，在连接成功之后，我们声明了一个交换器，这一个是很重要的，因为不允许发布消息到不存在的交换器。
如果没有绑定队列到交换器，消息将会丢失。但这个没有所谓，如果没有消费者监听，那么消息就会被忽略。
receive_logs.php的代码：
01<?php
02 
03/**
04 * PHP amqp(RabbitMQ) Demo-3
05 * @author  yuansir <yuansir@live.cn/yuansir-web.com>
06 */
07$exchangeName = 'logs';
08 
09$connection = new AMQPConnection(array('host' => '127.0.0.1', 'port' => '5672', 'vhost' => '/', 'login' => 'guest', 'password' => 'guest'));
10$connection->connect() or die("Cannot connect to the broker!\n");
11$channel = new AMQPChannel($connection);
12$exchange = new AMQPExchange($channel);
13$exchange->setName($exchangeName);
14$exchange->setType(AMQP_EX_TYPE_FANOUT);
15$exchange->declare();
16$queue = new AMQPQueue($channel);
17$queue->setFlags(AMQP_EXCLUSIVE);
18$queue->declare();
19$queue->bind($exchangeName, '');
20 
21var_dump('[*] Waiting for messages. To exit press CTRL+C');
22while (TRUE) {
23        $queue->consume('callback');
24}
25$connection->disconnect();
26 
27function callback($envelope, $queue) {
28        $msg = $envelope->getBody();
29        var_dump(" [x] Received:" . $msg);
30        $queue->nack($envelope->getDeliveryTag());
31}
这样我们就完成了。如果你想把日志保存到文件中，只需要打开控制台输入：
1$ php receive_logs.php > logs_from_rabbit.log
如果你想在屏幕中查看日志，那么打开一个新的终端然后运行：
1$ php receive_logs.php</pre>
当然还要发送日志：
1$ php emit_log.php
使用rabbitmqctl list_bindings你可确认已经创建了队列的绑定。你可以看到运行中的两个receive_logs.php程序：
1$ sudo rabbitmqctl list_bindings
2Listing bindings ...
3 ...
4logs    amq.gen-TJWkez28YpImbWdRKMa8sg==                []
5logs    amq.gen-x0kymA4yPzAT6BoC/YP+zw==                []
6...done.
显示结果很直观：logs交换器把数据发送给两个系统命名的队列。这就是我们所期望的。
如何监听消息的子集呢？让我们移步教程4
发帖者 时间：
标签： , ,

没有评论:

发表评论

订阅： 博文评论 (Atom)