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