EasySwoole

可信队列:RabbitMQ 驱动

RabbitMQ 驱动基于 php-amqplib/php-amqplib。发布和消费使用不同连接池:发布池服务并发 push(),消费端使用一个独立的 1/1 长连接池和后台消费协程。

启用协程 Hook

php-amqplib 内部使用 stream_select(),因此必须在协程启动前同时启用 TCP 和 Stream Hook:

use Swoole\Coroutine;

public static function initialize()
{
    Coroutine::set([
        'hook_flags' => SWOOLE_HOOK_TCP | SWOOLE_HOOK_STREAM_FUNCTION,
    ]);
}

在提供 SWOOLE_HOOK_STREAM_SELECT 的 Swoole 版本中,它与 SWOOLE_HOOK_STREAM_FUNCTION 表示相同的 Stream Hook。

创建队列

use EasySwoole\Queue\Driver\RabbitMQ\Config;
use EasySwoole\Queue\Driver\RabbitMQ\RabbitMQ;
use EasySwoole\Queue\Queue;

$config = new Config();
$config->setHost('127.0.0.1');
$config->setPort(5672);
$config->setUsername('easyswoole');
$config->setPassword('password');
$config->setVirtualHost('/easyswoole');
$config->setConnectTimeout(3.0);
$config->setReadWriteTimeout(25.0);
$config->setHeartbeat(10);
$config->setMinObjectNum(1);
$config->setMaxObjectNum(20);

$queue = new Queue(new RabbitMQ($config));

生产环境建议启用非零 heartbeat,以发现静默断线和 TCP 半开连接。readWriteTimeout 至少应为 heartbeat 的两倍,例如 heartbeat 为 10 秒时设置 25 秒。

消费结构

RabbitMQ Broker
      ↓ basic_consume
后台消费协程(独占一个 Channel)
      ↓
本地 Swoole Channel 缓冲区
      ↓ pop()
业务消费协程
      ↓ confirm()
后台消费协程统一 ACK

普通任务进入本地缓冲区后立即 ACK;可信任务会保留到业务调用 confirm()。ACK、确认超时和重新投递都由拥有原 Channel 的后台协程执行,不会为每条可信任务单独占用一个连接。

并发相关配置

方法 默认值 说明
setPrefetchCount() 100 单个消费 Channel 允许同时处理中、尚未确认的可信任务数
setConsumerBufferSize() 1000 Broker 消息进入 pop() 前的本地协程缓冲区容量
setPopPollInterval() 0.05 空队列短轮询间隔,秒
setQueuePrefix() easyswoole.queue. RabbitMQ 队列名称前缀
setKeepalive() false TCP keepalive

prefetchCount 不是越大越好。它过大时,单进程会积压过多未确认任务,并增加 confirm() 指令排队时间。应从默认值开始,根据消费进程的实际并发量和单任务耗时调整。

延迟任务注意事项

RabbitMQ 驱动通过消息 TTL、延迟队列和 Dead Letter Exchange 实现延迟任务。RabbitMQ 只检查队首消息是否过期;同一延迟队列中混用不同延迟时间时,短延迟消息可能被前面的长延迟消息阻塞。

如果业务要求严格的到点执行,可以采用固定 TTL 的分级队列、RabbitMQ 延迟消息插件,或者评估 Redis 驱动。

连接中断

可信任务尚未 ACK 时连接中断,RabbitMQ 会重新投递原消息。确认超时后,驱动会先通过 Publisher Confirm 发布带有最新 runTimes 的任务,再 ACK 原消息。即便如此,确认临界点发生网络异常时仍可能重复,因此业务幂等不可省略。

下一章:生产、消费与延迟任务。