(使用 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