playcatqueue的升级版之playcat/queue-webman

1.2.1 版本
2024-05-22 版本更新时间
33 安装
2 star

简介

之所以又重新做了一版是因为之前的版本还有一些功能没实现,但我又想能支持webman和tp+swoole,索性重构了代码。

  • 支持Redis单机或集群 (redis >= 5.0)
  • 支持Kafka
  • 支持RabbitMQ
  • 自定义异常与重试流程
  • (新)支持延迟消息数据持久化

安装

composer require "playcat/queue-webman"

1.配置

1.1

编辑 config\plugin\playcat\queue\ 目录下的app.phpprocess.php。修改相应内容为自己环境使用的配置。

1.2 初始化数据库(只需一次)

php webman timerserver:initdb

2.创建消费任务

新建一个php的文件并且添加以下内容:

<?php

namespace app\queue\playcat;

use Playcat\Queue\Protocols\ConsumerDataInterface;
use Playcat\Queue\Protocols\ConsumerInterface;

class playcatConsumer1 implements ConsumerInterface
{
    //任务名称,对应发布消息的名称
    public $queue = 'playcatqueue';

    public function consume(ConsumerData $payload)
    {
        //获取发布到队列时传入的内容
        $data = $payload->getQueueData();
        ...你自己的业务逻辑
        //休息10s
        sleep(10);
        echo('done!');
    }
}

ConsumerData方法

  • getID: 当前消息的id
  • getRetryCount(): 当前任务已经重试过的次数
  • getQueueData(): 当前任务传入的参数
  • getChannel(): 当前所执行的任务名称
    • -

将上面编写好的任务文件保存项目中'app/queue/playcat/'下(如果目录不存在则自己手动创建)

启动服务:

启动:
php start.php start

重载:可在不重启服务的情况下更新业务
php start.php reload

停止:
php start.php stop

如果没有错误出现则表示启动完成

添加任务并且提交到队列中

use Playcat\Queue\Manager;
use Playcat\Queue\Protocols\ProducerData;
//使用协程的方式,如果需要并行数据发布需要自行实现Manager的连接池
  //即时消费消息
  $payload = new ProducerData();
  //对应消费队列里的任务名称
  $payload->setChannel('test');
  //对应消费队列里的任务使用的数据
  $payload->setQueueData([1,2,3,4]);
  //推入队列并且获取消息id
  $id = Manager::getInstance()->push($payload);

  //延迟消费消息
  $payload_delay = new ProducerData();
  $payload_delay->setChannel('test');
  $payload_delay->setQueueData([6,7,8,9]);
  //设置60秒后执行的任务
  $payload_delay->setDelayTime(60);
  //推入队列并且获取消息id
  $id = Manager::getInstance()->push($payload_delay);
  //取消延迟消息
  Manager::getInstance()->del($id);

ProducerData方法

  • setChannel: 设置推入消息的队列名称
  • setQueueData: 设置传入到消费任务的数据
  • setDelayTime: 设置延迟时间(秒)
    • -

异常与重试机制

任务在执行过程中未抛出异常则默认执行成功,否则则进入重试阶段.
重试次数和时间由配置控制,重试间隔时间为当前重试次数的幂函数。
Playcat\Queue\Exceptions\DontRetry异常会忽略掉重试

其它

基于tp和swoole的队列系统
playcat-queue-tpswoole

QQ:318274085

赞助商