活动

天翼云最新优惠活动,涵盖免费试用,产品折扣等,助您降本增效!
热门活动
  • 618智算钜惠季 爆款云主机2核4G限时秒杀,88元/年起!
  • 免费体验DeepSeek,上天翼云息壤 NEW 新老用户均可免费体验2500万Tokens,限时两周
  • 云上钜惠 HOT 爆款云主机全场特惠,更有万元锦鲤券等你来领!
  • 算力套餐 HOT 让算力触手可及
  • 天翼云脑AOne NEW 连接、保护、办公,All-in-One!
  • 中小企业应用上云专场 产品组合下单即享折上9折起,助力企业快速上云
  • 息壤高校钜惠活动 NEW 天翼云息壤杯高校AI大赛,数款产品享受线上订购超值特惠
  • 天翼云电脑专场 HOT 移动办公新选择,爆款4核8G畅享1年3.5折起,快来抢购!
  • 天翼云奖励推广计划 加入成为云推官,推荐新用户注册下单得现金奖励
免费活动
  • 免费试用中心 HOT 多款云产品免费试用,快来开启云上之旅
  • 天翼云用户体验官 NEW 您的洞察,重塑科技边界

智算服务

打造统一的产品能力,实现算网调度、训练推理、技术架构、资源管理一体化智算服务
智算云(DeepSeek专区)
科研助手
  • 算力商城
  • 应用商城
  • 开发机
  • 并行计算
算力互联调度平台
  • 应用市场
  • 算力市场
  • 算力调度推荐
一站式智算服务平台
  • 模型广场
  • 体验中心
  • 服务接入
智算一体机
  • 智算一体机
大模型
  • DeepSeek-R1-昇腾版(671B)
  • DeepSeek-R1-英伟达版(671B)
  • DeepSeek-V3-昇腾版(671B)
  • DeepSeek-R1-Distill-Llama-70B
  • DeepSeek-R1-Distill-Qwen-32B
  • Qwen2-72B-Instruct
  • StableDiffusion-V2.1
  • TeleChat-12B

应用商城

天翼云精选行业优秀合作伙伴及千余款商品,提供一站式云上应用服务
进入甄选商城进入云市场创新解决方案
办公协同
  • WPS云文档
  • 安全邮箱
  • EMM手机管家
  • 智能商业平台
财务管理
  • 工资条
  • 税务风控云
企业应用
  • 翼信息化运维服务
  • 翼视频云归档解决方案
工业能源
  • 智慧工厂_生产流程管理解决方案
  • 智慧工地
建站工具
  • SSL证书
  • 新域名服务
网络工具
  • 翼云加速
灾备迁移
  • 云管家2.0
  • 翼备份
资源管理
  • 全栈混合云敏捷版(软件)
  • 全栈混合云敏捷版(一体机)
行业应用
  • 翼电子教室
  • 翼智慧显示一体化解决方案

合作伙伴

天翼云携手合作伙伴,共创云上生态,合作共赢
天翼云生态合作中心
  • 天翼云生态合作中心
天翼云渠道合作伙伴
  • 天翼云代理渠道合作伙伴
天翼云服务合作伙伴
  • 天翼云集成商交付能力认证
天翼云应用合作伙伴
  • 天翼云云市场合作伙伴
  • 天翼云甄选商城合作伙伴
天翼云技术合作伙伴
  • 天翼云OpenAPI中心
  • 天翼云EasyCoding平台
天翼云培训认证
  • 天翼云学堂
  • 天翼云市场商学院
天翼云合作计划
  • 云汇计划
天翼云东升计划
  • 适配中心
  • 东升计划
  • 适配互认证

开发者

开发者相关功能入口汇聚
技术社区
  • 专栏文章
  • 互动问答
  • 技术视频
资源与工具
  • OpenAPI中心
开放能力
  • EasyCoding敏捷开发平台
培训与认证
  • 天翼云学堂
  • 天翼云认证
魔乐社区
  • 魔乐社区

支持与服务

为您提供全方位支持与服务,全流程技术保障,助您轻松上云,安全无忧
文档与工具
  • 文档中心
  • 新手上云
  • 自助服务
  • OpenAPI中心
定价
  • 价格计算器
  • 定价策略
基础服务
  • 售前咨询
  • 在线支持
  • 在线支持
  • 工单服务
  • 建议与反馈
  • 用户体验官
  • 服务保障
  • 客户公告
  • 会员中心
增值服务
  • 红心服务
  • 首保服务
  • 客户支持计划
  • 专家技术服务
  • 备案管家

了解天翼云

天翼云秉承央企使命,致力于成为数字经济主力军,投身科技强国伟大事业,为用户提供安全、普惠云服务
品牌介绍
  • 关于天翼云
  • 智算云
  • 天翼云4.0
  • 新闻资讯
  • 天翼云APP
基础设施
  • 全球基础设施
  • 信任中心
最佳实践
  • 精选案例
  • 超级探访
  • 云杂志
  • 分析师和白皮书
  • 天翼云·创新直播间
市场活动
  • 2025智能云生态大会
  • 2024智算云生态大会
  • 2023云生态大会
  • 2022云生态大会
  • 天翼云中国行
天翼云
  • 活动
  • 智算服务
  • 产品
  • 解决方案
  • 应用商城
  • 合作伙伴
  • 开发者
  • 支持与服务
  • 了解天翼云
      • 文档
      • 控制中心
      • 备案
      • 管理中心
      文档中心

      分布式消息服务RocketMQ

      分布式消息服务RocketMQ

        • 产品动态
        • 服务公告
        • 2024
        • 【优惠】正式开放2年7折,3年5折包年折扣
        • 【优惠】分布式消息服务RocketMQ增加包年优惠折扣和产品资费下调
        • 【通知】CTGMQ引擎调整为白名单特性
        • 【通知】通用型主机规格调整为白名单特性
        • 产品简介
        • 产品定义
        • 产品优势
        • 功能特性
        • 应用场景
        • 产品规格
        • 开源对比
        • 分布式消息产品选型
        • 使用限制
        • 安全方案
        • 名词解释
        • 产品架构
        • 与其他服务关系
        • 计费说明
        • 产品资费
        • 新资费
        • 旧资费
        • 计费项
        • 计费模式
        • 续费、到期与欠费
        • 退订
        • 快速入门
        • 入门指引
        • 环境准备
        • 创建RocketMQ实例
        • 创建主题和订阅组
        • 创建应用用户和密码
        • 生产消费验证
        • 用户指南
        • 创建实例
        • 实例管理
        • 查看实例
        • 修改实例
        • 连接实例
        • 扩容
        • 按需转包周期
        • 续订和退订
        • 概览
        • 集群信息
        • 标签管理
        • Topic管理
        • 查看Topic
        • 创建Topic
        • 修改Topic
        • 删除Topic
        • 拨测
        • 重置消费位置
        • Topic导入/导出
        • 消费组管理
        • 查看消费组
        • 创建消费组
        • 修改消费组
        • 删除消费组
        • 消费组导入/导出
        • 查看订阅关系
        • 用户权限管理
        • 消息查询
        • 查询消息
        • 消息轨迹
        • 生产者实例查询
        • 消费者实例查询
        • 监控与告警
        • 监控指标说明
        • 集群监控
        • 仪表盘
        • 配置告警
        • 最佳实践
        • 生产者
        • 消费者
        • topic、queue的规划
        • Java客户端Pull和Push的选择:Java客户端必须使用Push Consumer
        • 有序消费和无序消费的选择
        • 消费幂等
        • 业务消息设计:Topic与Tag
        • 同组Consumer订阅关系一致
        • 开发指南
        • 概述
        • 收集连接信息
        • Java
        • 收发普通消息
        • 收发顺序消息
        • 收发事务消息
        • 收发定时/延时消息
        • 消费限流
        • Go
        • 收发普通消息
        • 收发顺序消息
        • 收发事务消息
        • 收发定时/延时消息
        • Python
        • 收发普通消息
        • 收发顺序消息
        • 收发事务消息
        • 收发定时/延时消息
        • 性能白皮书
        • RocketMQ性能白皮书
        • API参考
        • API使用说明
        • SDK参考
        • SDK概述
        • RocketMQ C++ SDK
        • RocketMQ .NET SDK
        • RocketMQ PHP SDK
        • 常见问题
        • 计费类
        • 购买类
        • 操作类
        • 管理类
        • 产品类
        • 相关协议
        • 服务等级协议
        • 服务条款
          无相关产品

          本页目录

          帮助中心分布式消息服务RocketMQSDK参考RocketMQ PHP SDK
          RocketMQ PHP SDK
          更新时间 2024-09-06 01:04:30
          • 新浪微博
          • 微信
            扫码分享
          • 复制链接
          最近更新时间: 2024-09-06 01:04:30
          分享文章
          • 新浪微博
          • 微信
            扫码分享
          • 复制链接
          说明

          分布式消息服务RocketMQ兼容了社区版 HTTP SDK,您可以使用社区版 HTTP SDK接入分布式消息服务RocketMQ。

          前提条件:

          1. 在PHP安装目录下的composer.json文件中加入社区PHP SDK 依赖。

          2. 使用Composer安装依赖。

            composer install
            

          发送普通消息

          <?phprequire "vendor/autoload.php";use MQ\Model\TopicMessage;use MQ\MQClient;class NormalProducerExample{
              private $client;
              private $producer;
          
              public function __construct()
              {
                  $this->client = new MQClient(
                  // 填写分布式消息服务RocketMQ控制台HTTP接入点
                      "${HTTP_ENDPOINT}",
                      // 填写AccessKey,在管理控制台创建
                      "${ACCESS_KEY}",
                      // 填写SecretKey 在管理控制台创建
                      "${SECRET_KEY}"
                  );
          
                  // 所属的 Topic
                  $topic = "${TOPIC}";
                  // Topic所属实例ID,默认实例为空NULL
                  $instanceId = "${INSTANCE_ID}";
          
                  $this->producer = $this->client->getProducer($instanceId, $topic);
              }
          
              public function run()
              {
                  try {
                      for ($i = 1; $i <= 4; $i++) {
                          $publishMessage = new TopicMessage(
                              "Hello RocketMQ" // 消息内容
                          );
          
                          // 设置属性
                          $publishMessage->putProperty("a", $i);
                          // 设置消息KEY
                          $publishMessage->setMessageKey("MessageKey");
          
                          $result = $this->producer->publishMessage($publishMessage);
                          print "Send mq message success. msgId is:" . $result->getMessageId() . ", bodyMD5 is:" . $result->getMessageBodyMD5() . "\n";
                      }
                  } catch (\Exception $e) {
                      print_r($e->getMessage() . "\n");
                  }
              }}$instance = new NormalProducerExample();$instance->run();?>
          

          消费普通消息

          <?phprequire "vendor/autoload.php";use MQ\MQClient;class ConsumerExample{
              private $client;
              private $consumer;
          
              public function __construct()
              {
                  $this->client = new MQClient(
                      // 填写分布式消息服务RocketMQ控制台HTTP接入点
                      "${HTTP_ENDPOINT}",
                      // 填写AccessKey,在管理控制台创建
                      "${ACCESS_KEY}",
                      // 填写SecretKey 在管理控制台创建
                      "${SECRET_KEY}"
                  );
          
                  // 所属的 Topic
                  $topic = "${TOPIC}";
                  // 您在控制台创建的 Consumer ID(Group ID)
                  $groupId = "${GROUP_ID}";
                  // Topic所属实例ID,默认实例为空NULL
                  $instanceId = "${INSTANCE_ID}";
          
                  $this->consumer = $this->client->getConsumer($instanceId, $topic, $groupId, "TagA");
              }
          
              public function run()
              {
                  // 在当前线程循环消费消息,建议是多开个几个线程并发消费消息
                  while (True) {
                      try {
                          // 长轮询消费消息
                          // 长轮询表示如果topic没有消息则请求会在服务端挂住3s,3s内如果有消息可以消费则立即返回
                          $messages = $this->consumer->consumeMessage(
                              3, // 一次最多消费3条(最多可设置为16条)
                              3 // 长轮询时间3秒(最多可设置为30秒)
                          );
                      }  catch (\MQ\Exception\MessageResolveException $e) {
                          // 当出现消息Body存在不合法字符,无法解析的时候,会抛出此异常。
                          // 可以正常解析的消息列表。
                          $messages = $e->getPartialResult()->getMessages();
                          // 无法正常解析的消息列表。
                          $failMessages = $e->getPartialResult()->getFailResolveMessages();
          
                          $receiptHandles = array();
                          foreach ($messages as $message) {
                              // 处理业务逻辑。
                              $receiptHandles[] = $message->getReceiptHandle();
                              printf("MsgID %s\n", $message->getMessageId());
                          }
                          foreach ($failMessages as $failMessage) {
                              // 处理存在不合法字符,无法解析的消息。
                              $receiptHandles[] = $failMessage->getReceiptHandle();
                              printf("Fail To Resolve Message. MsgID %s\n", $failMessage->getMessageId());
                          }
                          $this->ackMessages($receiptHandles);
                          continue;
                      } catch (\Exception $e) {
                          if ($e instanceof MQ\Exception\MessageNotExistException) {
                              // 没有消息可以消费,接着轮询
                              printf("No message, contine long polling!RequestId:%s\n", $e->getRequestId());
                              continue;
                          }
          
          
          
                          print_r($e->getMessage() . "\n");
          
                          sleep(3);
                          continue;
                      }
          
                      print "consume finish, messages:\n";
          
                      // 处理业务逻辑
                      $receiptHandles = array();
                      foreach ($messages as $message) {
                          $receiptHandles[] = $message->getReceiptHandle();
                          printf("MessageID:%s TAG:%s BODY:%s \nPublishTime:%d, FirstConsumeTime:%d, \nConsumedTimes:%d, NextConsumeTime:%d,MessageKey:%s\n",
                              $message->getMessageId(), $message->getMessageTag(), $message->getMessageBody(),
                              $message->getPublishTime(), $message->getFirstConsumeTime(), $message->getConsumedTimes(), $message->getNextConsumeTime(),
                              $message->getMessageKey());
                          print_r($message->getProperties());
                      }
          
                      // $message->getNextConsumeTime()前若不确认消息消费成功,则消息会重复消费
                      // 消息句柄有时间戳,同一条消息每次消费拿到的都不一样
                      print_r($receiptHandles);
                      try {
                          $this->ackMessages($receiptHandles);
                      } catch (\Exception $e) {
                          if ($e instanceof MQ\Exception\AckMessageException) {
                              // 某些消息的句柄可能超时了会导致确认不成功
                              printf("Ack Error, RequestId:%s\n", $e->getRequestId());
                              foreach ($e->getAckMessageErrorItems() as $errorItem) {
                                  printf("\tReceiptHandle:%s, ErrorCode:%s, ErrorMsg:%s\n", $errorItem->getReceiptHandle(), $errorItem->getErrorCode(), $errorItem->getErrorCode());
                              }
                          }
                      }
                      print "ack finish\n";
                  }
          
              }
          
              public function ackMessages($receiptHandles)
              {
                  try {
                      $this->consumer->ackMessage($receiptHandles);
                  } catch (\Exception $e) {
                      if ($e instanceof MQ\Exception\AckMessageException) {
                          // 某些消息的句柄可能超时,会导致消费确认失败。
                          printf("Ack Error, RequestId:%s\n", $e->getRequestId());
                          foreach ($e->getAckMessageErrorItems() as $errorItem) {
                              printf("\tReceiptHandle:%s, ErrorCode:%s, ErrorMsg:%s\n", $errorItem->getReceiptHandle(), $errorItem->getErrorCode(), $errorItem->getErrorCode());
                          }
                      }
                  }
              }}$instance = new ConsumerExample();$instance->run();?>
          
          文档反馈

          建议您登录后反馈,可在建议与反馈里查看问题处理进度

          鼠标选中文档,精准反馈问题

          选中存在疑惑的内容,即可快速反馈问题,我们会跟进处理

          知道了

          上一篇 :  RocketMQ .NET SDK
          下一篇 :  常见问题
          搜索 关闭
          ©2025 天翼云科技有限公司版权所有 增值电信业务经营许可证A2.B1.B2-20090001
          公司地址:北京市东城区青龙胡同甲1号、3号2幢2层205-32室
          备案 京公网安备11010802043424号 京ICP备 2021034386号
          ©2025天翼云科技有限公司版权所有
          京ICP备 2021034386号
          备案 京公网安备11010802043424号
          增值电信业务经营许可证A2.B1.B2-20090001
          用户协议 隐私政策 法律声明