RabbitMQ译文 — 主题(Topics)

(使用 php-amqplib)

  在上一篇教程中我们升级了我们的日志系统,用一个“direct”交换来代替仅能做模拟广播的“fanout”交换,以此来达到可以选择性接收日志的功能。

  尽管使用“direct”交换升级了我们的系统,它仍然有局限性——它不能基于多个标准做路由。

  在我们的日志系统内,我们可能想不仅基于严重性,还基于发送日志的来源来订阅日志,你可能从syslog unix 工具中了解这个概念,这个工具同时根据严重性(info/warn/crit...)和设备(auth/cron/kern...)两者来路由日志。

  这可能给我们很多便利——我们可能只想监听来自“cron”的致命错误,但也要监听来自“kern”的所有错误。

  为了在我们的日志系统内实现这个功能,我们需要学习一个更复杂的“topic”交换。

一、Topic 交换(Topic exchange)

  消息发给一个“topic”交换不能只有一个任意的路由键——它必须是一个被点分割的单词列表。这些单词可以是任意的,但是同城它们被指定一些和消息有关的特征。例如:“stock.usd.nyse”, “nyse.vmw”, “quick.orange.rabbit”就是一些合法的路由键。根据你的需要,路由键中可以有很多的单词,但最多255个字节。

  绑定键也必须是相同的格式,“topic”交换逻辑的背后和一个“direct”交换相似——一条带有一个特定路由键的消息被发送后,将被传递给所有绑定一个匹配绑定键的队列。然而,对于绑定键,还有两个重要的他特殊情况。

  • * (星号) 可以代替一个单词。
  • # (井号) 可以代替零或多个单词。

  在下面这个例子里很容易的解释了这个概念:

 

   在这个例子里,我们打算发送描述动物的一些消息。这些带有由三个单词(两个点)组成的路由键的消息将被发送。在路由键里的第一个单词将描述速度,第二个描述颜色,第三个描述物种:“<speed>.<colour>.<species>”。

  我们建立了三个绑定:Q1用绑定键"*.orange.*"绑定 ,Q2绑定"*.*.rabbit"和"lazy.#"。

  这些绑定能被概括为:

  • Q1对所有橙色动物感兴趣。
  • Q2想监听关于兔子的所有消息,以及行动迟缓动物的每个消息。

   一条设置路由键“quick.orange.rabbit”的消息将被传递到两个队列。设置“lazy.orange.elephant“键的消息也将被传递到这个两个队列。另一方面,带有"quick.orange.fox"键的消息将仅仅被传递到第一个队列,而带有“lazy.brown.fox”键的消息仅被传到第二个。绑定“lazy.pink.rabbit”的消息将仅被传递给第二个队列一次,即使它匹配两个绑定。带有"quick.brown.fox"键的消息不匹配任何绑定,因此它将被丢弃。

  如果我们打破我们的约定,发送一条带有一个或四个单词的消息,例如“orange”或者“quick.orange.male.rabbit”会怎样呢?好吧,这些消息不匹配任何绑定将会丢失。

  另一方面,“lazy.orange.male.rabbit”即使它有四个单词,但会匹配最后那个绑定,将被发送到第二个队列。

Topic 交换

Topic 交换非常强大,可以像其它交换一样运行

当一个队列被绑定“#”(井号)绑定键——它将接收所有消息,不论路由键是什么——就像是“fanout”交换。

When special characters "*" (star) and "#" (hash) aren't used in bindings, the topic exchange will behave just like a direct one.

当特殊字符“*”(星号)和“#”(井号)没有被用在绑定里,“topic”交换就像是“direct”交换一样了。

二、合在一起(Putting it all together)

  我们将在我们的日志系统内使用一个“topic”交换。我们将首先假设日志的路由键有两个单词“<facility>.<severity>”。

  代码几乎和前面教程里的一样。

   emit_log_topic.php 代码如下:

<?php

require_once __DIR__ . '/vendor/autoload.php';
use PhpAmqpLibConnectionAMQPStreamConnection;
use PhpAmqpLibMessageAMQPMessage;

$connection = new AMQPStreamConnection('localhost', 5672, 'guest', 'guest');
$channel = $connection->channel();

$channel->exchange_declare('topic_logs', 'topic', false, false, false);

$routing_key = isset($argv[1]) && !empty($argv[1]) ? $argv[1] : 'anonymous.info';
$data = implode(' ', array_slice($argv, 2));
if (empty($data)) {
    $data = "Hello World!";
}

$msg = new AMQPMessage($data);

$channel->basic_publish($msg, 'topic_logs', $routing_key);

echo ' [x] Sent ', $routing_key, ':', $data, "
";

$channel->close();
$connection->close();

   receive_logs_topic.php 代码如下:

<?php

require_once __DIR__ . '/vendor/autoload.php';
use PhpAmqpLibConnectionAMQPStreamConnection;

$connection = new AMQPStreamConnection('localhost', 5672, 'guest', 'guest');
$channel = $connection->channel();

$channel->exchange_declare('topic_logs', 'topic', false, false, false);

list($queue_name, ,) = $channel->queue_declare("", false, false, true, false);

$binding_keys = array_slice($argv, 1);
if (empty($binding_keys)) {
    file_put_contents('php://stderr', "Usage: $argv[0] [binding_key]
");
    exit(1);
}

foreach ($binding_keys as $binding_key) {
    $channel->queue_bind($queue_name, 'topic_logs', $binding_key);
}

echo " [*] Waiting for logs. To exit press CTRL+C
";

$callback = function ($msg) {
    echo ' [x] ', $msg->delivery_info['routing_key'], ':', $msg->body, "
";
};

$channel->basic_consume($queue_name, '', false, true, false, false, $callback);

while ($channel->is_consuming()) {
    $channel->wait();
}

$channel->close();
$connection->close();

  接收所有日志:

php receive_logs_topic.php "#"

  接收所有来自设备“kern”的日志:

php receive_logs_topic.php "kern.*"

  或者如果你只想要“critical”日志:

php receive_logs_topic.php "*.critical"

  你可以建立多个绑定:

php receive_logs_topic.php "kern.*" "*.critical"

  发送一个带有路由键“kern.critical”类型的日志:

php emit_log_topic.php "kern.critical" "A critical kernel error"

  玩这些程序很开心吧,注意代码不会对路由和绑定键做出任何假设,或许你还想用多于两个的路由键的参数。

  (这是 emit_log_topic.php 和 receive_logs_topic.php 的完整源代码)

  下面,在第六节里来了解怎样做一个往返消息,来作为一个远程过程的调用。

  原文:https://www.rabbitmq.com/tutorials/tutorial-five-php.html

原文地址:https://www.cnblogs.com/penrodsheh/p/13201646.html