RabbitMQ+PHP 教程四（Routing）

using php-amqplib

前提必读

本教程假设 RabbitMQ 是运行在标准端口上运行（5672）.
如果您使用不同的主机、端口或凭据，则连接设置需要调整。

如果您在本教程中遇到困难，可以通过邮件列表与我们联系。

在前面的教程中，我们构建了一个简单的日志系统。我们能够向许多接收者广播日志消息。

开始

在本教程中，我们将为它添加一个特性——我们将只可能订阅消息的一个子集。例如，我们只能够将关键错误消息直接指向日志文件（以节省磁盘空间），同时仍然能够打印控制台上的所有日志消息。

绑定（Bindings）

在前面的示例中，我们已经创建绑定。您可能还记得代码：

$channel->queue_bind($queue_name, 'logs');

绑定是交换和队列之间的一种关系。这可以简单地理解为：队列对来自此交换的消息感兴趣。

绑定可以采取额外的routing_key参数。避免混淆和$channel::basic_publish参数我们要叫它绑定key。这就是我们如何用键创建绑定的原因：

$binding_key = 'black';
$channel->queue_bind($queue_name, $exchange_name, $binding_key);

绑定键的含义取决于交换类型。我们以前使用的fanout交换将忽略了它的值。

Direct exchange

我们以前的教程中的日志系统将所有消息广播给所有消费者。我们希望扩展这一点，允许基于其一定严重性程度来过滤消息。例如，我们可能希望将日志消息写入到磁盘的脚本只接收关键错误，而不会在警告或信息日志消息上浪费磁盘空间。

我们使用的是fanout交换机，这并不能给我们带来很大的灵活性——它只能进行无意识的广播。

我们将使用direct交换机替代。direct交换机背后的路由算法很简单-消息传递到队列，其绑定键完全匹配消息的路由键。

为了说明这一点，请考虑以下设置：

在这个设置中，我们可以看到两个队列绑定到它的direct交换机X。第一个队列与绑定键orange绑定，第二个绑定有两个绑定，一个绑定键black，另一个绑定green。

在这样的设置中，将路由消息发送到Exchange的路由密钥orange将被路由到队列Q1。带有black或green路由键的消息将转到Q2。所有其他消息都将被丢弃。

多个绑定 (Multiple bindings)

用相同的绑定键绑定多个队列是完全合法的。在我们的示例中，我们可以在绑定绑定键X和Q1之间添加一个绑定。在这种情况下，direct交换机将表现为fanout交换机，并将消息发送到所有匹配队列。将带有路由键black的消息发送给Q1和Q2。

Emitting logs

我们将使用这个模型作为我们的日志系统。我们将把消息发送给direct交换机，而不是fanout交换机。我们将提供日志严重性作为路由键。这样，接收脚本将能够选择它想要接收的严重性。让我们先专注于发布日志。

和以往一样，我们需要首先创建一个交换：

$channel->exchange_declare('direct_logs', 'direct', false, false, false);

我们已经准备好发送消息了：

$channel->exchange_declare('direct_logs', 'direct', false, false, false);
$channel->basic_publish($msg, 'direct_logs', $severity);

为了简化事情，我们会假设严重错误有可以是info, warning, error的一种。

订阅 (Subscribing)

接收消息将与前面的教程一样，只有一个例外——我们将为我们感兴趣的每个严重性创建一个新的绑定。

foreach($severities as $severity) {
    $channel->queue_bind($queue_name, 'direct_logs', $severity);
}

代码都放在一起：

emit_log_direct.php源码:

<?php

require_once __DIR__ . '/vendor/autoload.php';
use PhpAmqpLib\Connection\AMQPStreamConnection;
use PhpAmqpLib\Message\AMQPMessage;

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

$channel->exchange_declare('direct_logs', 'direct', false, false, false);

$severity = isset($argv[1]) && !empty($argv[1]) ? $argv[1] : 'info';

$data = implode(' ', array_slice($argv, 2));
if(empty($data)) $data = "Hello World!";

$msg = new AMQPMessage($data);

$channel->basic_publish($msg, 'direct_logs', $severity);

echo " [x] Sent ",$severity,':',$data," \n";

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

?>

receive_logs_direct.php源码:

<?php

require_once __DIR__ . '/vendor/autoload.php';
use PhpAmqpLib\Connection\AMQPStreamConnection;

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

$channel->exchange_declare('direct_logs', 'direct', false, false, false);

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

$severities = array_slice($argv, 1);
if(empty($severities )) {
    file_put_contents('php://stderr', "Usage: $argv[0] [info] [warning] [error]\n");
    exit(1);
}

foreach($severities as $severity) {
    $channel->queue_bind($queue_name, 'direct_logs', $severity);
}

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

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

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

while(count($channel->callbacks)) {
    $channel->wait();
}

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

?>

如果您只想保存warning 和 error（不包含info）日志消息到文件，只需打开控制台并键入：

php receive_logs_direct.php warning error > logs_from_rabbit.log

如果您想查看屏幕上的所有日志消息，请打开一个新的终端并执行：

php receive_logs_direct.php info warning error
# => [*] Waiting for logs. To exit press CTRL+C

例如，触发错误日志消息：

php emit_log_direct.php error "Run. Run. Or it will explode."
# => [x] Sent 'error':'Run. Run. Or it will explode.'

(全部源码 emit_log_direct.php source and receive_logs_direct.php source)

学习如何基于模式侦听消息， 你可以阅读下一章节：RabbitMQ+PHP 教程五(Topics)。

翻译来自 RabbitMQ - RabbitMQ tutorial - Routing