ghf / aliyun-mq-http-sdk

1.0.0 2026-10-27 03:09 UTC

Requires

• php: >=8.4
• ext-dom: *
• ext-xmlreader: *
• guzzlehttp/guzzle: ^7.9

MIT

• queue
• message
• MQ
• message queue
• aliyun
• alicloud

Published on Packagist.org on 2026-10-27 03:11 UTC

README

Alyun MQ Documents: http://www.aliyun.com/product/ons

Aliyun MQ Console: https://ons.console.aliyun.com

Intall Composer

To install composer by following commands, or see composer

curl -sS https://getcomposer.org/installer | php
mv composer.phar /usr/local/bin/composer

Install & Use

Add require to your composer.json

{
  "require": {
     "aliyunmq/mq-http-sdk": ">=1.0.4"
  }
}

Use Composer to install requires

composer install

Note: php version>=8.4, and ext-dom / ext-xmlreader extensions of php are required.

PHP 8.4+ 改版说明（breaking changes）

相对官方 aliyunmq/mq-http-sdk 1.0.4，本版本为支持 PHP 8.4/8.5 做了以下不兼容调整：

1. 生产者/消费者构造函数参数顺序调整（可选参数 $instanceId 移到末尾）：
   • MQProducer(HttpClient $client, $topicName, $instanceId = null)
   • MQTransProducer(HttpClient $client, $topicName, $groupId, $instanceId = null)
   • MQConsumer(HttpClient $client, $topicName, $consumer, $messageTag = null, $instanceId = null)
   • 通过 MQClient::getProducer()/getConsumer()/getTransProducer() 调用的代码无需修改。
2. Guzzle 约束升级为 ^7.9；HttpClient 构造选项不再使用 Guzzle 5 的 defaults 包装。
3. 全部隐式可空参数改为显式 ?Type，修复 PHP 8.4 弃用告警；MQException 对 $code 做了 int 归一化。

Note

1. Http consumer only support timer msg (less than 3 days), no matter the msg is produced from http or tcp protocol.
2. Order is only supported at special server cluster.

Samples (github)

Publish Message

Consume Message

Transaction Message

Publish Order Message

Consume Order Message

Samples (code.aliyun.com)

Publish Message

Consume Message

Transaction Message

Publish Order Message

Consume Order Message