2019年12月10日10:02:52
原文:https://www.rabbitmq.com/tutorials/tutorial-four-php.html
路由
(使用php-amqplib)
先决条件
本教程假定RabbitMQ 已在标准端口(5672)的本地主机上安装并运行。如果您使用其他主机,端口或凭据,则连接设置需要进行调整。
在哪里获得帮助
如果您在阅读本教程时遇到困难,可以 通过邮件列表与我们联系。
在上一教程中,我们构建了一个简单的日志记录系统。我们能够向许多接收者广播日志消息。
在本教程中,我们将向其中添加功能-我们将使仅订阅消息的子集成为可能。例如,我们将只能将严重错误消息定向到日志文件(以节省磁盘空间),同时仍然能够在控制台上打印所有日志消息。
绑定
在前面的示例中,我们已经在创建绑定。您可能会想起类似的代码:
$channel->queue_bind($queue_name, 'logs');
绑定是交换和队列之间的关系。可以简单地理解为:队列对来自此交换的消息感兴趣。
绑定可以使用额外的routing_key参数。为了避免与$ channel :: basic_publish参数混淆,我们将其称为 绑定键。这是我们可以创建带有键的绑定的方法:
$binding_key = 'black'; $channel->queue_bind($queue_name, $exchange_name, $binding_key);
绑定密钥的含义取决于交换类型。我们之前使用的 扇出交换只是忽略了它的价值。
直接交换
上一教程中的日志系统将所有消息广播给所有使用者。我们想要扩展它以允许根据邮件的严重性过滤邮件。例如,我们可能希望将日志消息写入磁盘的脚本仅接收严重错误,而不会在警告或信息日志消息上浪费磁盘空间。
我们使用的是扇出交换机,它并没有给我们带来太大的灵活性-它只能进行无意识的广播。
我们将使用直接交换。直接交换背后的路由算法很简单-消息进入其绑定密钥与消息的路由密钥完全匹配的队列 。
为了说明这一点,请考虑以下设置:
在此设置中,我们可以看到绑定了两个队列的直接交换X。第一个队列绑定键为橙色,第二个绑定键为两个,一个绑定键为black,另一个绑定键为green。
在这种设置中,使用路由键橙色发布到交换机的消息 将被路由到队列Q1。路由键为黑色 或绿色的消息将转到Q2。所有其他消息将被丢弃。
多重绑定
用相同的绑定密钥绑定多个队列是完全合法的。在我们的示例中,我们可以使用绑定键black在X和Q1之间添加绑定。在这种情况下,直接交换的行为将类似于扇出,并将消息广播到所有匹配的队列。带有黑色路由键的消息将同时传递给 Q1和Q2。
发射日志
我们将在记录系统中使用此模型。我们将发送消息到直接交换机,而不是扇出。我们将提供日志严重性作为路由键。这样,接收脚本将能够选择其想要接收的严重性。让我们首先关注发射日志。
与往常一样,我们需要首先创建一个交换:
$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);
为简化起见,我们将假定“严重性”可以是“信息”,“警告”,“错误”之一。
订阅
接收消息的工作方式与上一教程一样,但有一个例外-我们将为感兴趣的每种严重性创建一个新的绑定。
foreach ($severities as $severity) { $channel->queue_bind($queue_name, 'direct_logs', $severity); }
放在一起
emit_log_direct.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('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, " "; $channel->close(); $connection->close();
receive_logs_direct.php的代码:
<?php require_once __DIR__ . '/vendor/autoload.php'; use PhpAmqpLibConnectionAMQPStreamConnection; $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] "); exit(1); } foreach ($severities as $severity) { $channel->queue_bind($queue_name, 'direct_logs', $severity); } 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_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源代码) 和(receive_logs_direct.php源代码)的完整源代码)
继续学习第5篇教程,以了解如何根据模式侦听消息。