Thumper 技术文档

1. 安装指南

Thumper 是一个 PHP 库，旨在抽象 RabbitMQ 上可以实现的几种消息模式。要安装 Thumper，您可以使用 Composer。以下是安装步骤：

$ composer require php-amqplib/thumper

确保您的环境中已经安装了 Composer。

2. 项目的使用说明

Thumper 提供了多种消息模式的实现，包括 RPC、并行处理、简单的队列服务器和发布/订阅。在项目的 _examples_ 文件夹中，您可以看到如何实现这些模式的示例。

所有示例都假定 RabbitMQ 正在运行，并且已经使用 RabbitMQ 2.1.1 版本进行了测试。

• 队列服务器（Queue Server）: 这个示例展示了如何创建一个生产者，它将发布作业到队列中，这些作业稍后会被消费者（或多个消费者）处理。
• RPC: 此示例展示了如何在 RabbitMQ 上实现 RPC。有一个 RPC 客户端发送请求到一个服务器，该服务器返回提供字符串的字符数。服务器代码位于 _parallel_processing 文件夹中。
• 并行处理（Parallel Processing）: 此示例基于 RPC 示例。在这种情况下，它展示了如何使用 PHP 实现并行执行。假设您有两个耗时的任务，一个需要 5 秒钟，另一个需要 10 秒钟。您可以选择顺序执行它们，等待总共 15 秒，或者并行发送请求，然后等待最慢的任务完成，这应该只需要 10 秒。
• 主题（Topic）: 在这个案例中，可以看到如何使用 RabbitMQ 实现发布/订阅。示例是关于日志记录的。可以记录不同级别和主题的日志，然后有不同的消费者根据不同的日志级别进行相应的操作。
• 匿名消费者（Anonymous Consumers）: 在 _topic 文件夹中还有一个匿名消费者示例。这个想法适用于需要将队列连接到某些交换以“监视”其内容，但在退出程序时，您希望队列被自动删除的情况。可以使用未命名队列来实现这一点。

每个示例都有一个 README.md 文件，说明了如何执行它们。

3. 项目API使用文档

以下是 Thumper 库的一些基本 API 使用示例：

• 发布消息:

$producer = new Thumper\Producer($connection);
$producer->setExchangeOptions(array('name' => 'hello-exchange', 'type' => 'direct'));
$producer->publish($argv[1]);

• 消费消息:

$myConsumer = function($msg)
{
  echo $msg, "\n";
};

$consumer = new Thumper\Consumer($connection);
$consumer->setExchangeOptions(array('name' => 'hello-exchange', 'type' => 'direct'));
$consumer->setQueueOptions(array('name' => 'hello-queue'));
$consumer->setCallback($myConsumer); //myConsumer 可以是任何有效的 PHP 回调
$consumer->consume(5); // 5 是要消费的消息数量

请参考官方文档或示例代码以获取更详细的 API 使用说明。

4. 项目安装方式

Thumper 可以通过 Composer 进行安装，这是 PHP 项目推荐的依赖管理工具。确保您已经在您的项目中安装了 Composer，然后运行以下命令：

$ composer require php-amqplib/thumper

以上命令将自动处理所有依赖项，并将 Thumper 库安装到您的项目中。

请注意，使用 Thumper 库之前，请确保您的系统中已经安装了 RabbitMQ，并且服务正在运行。