- 添加 toArray 方法
在上个版本中为 getContents 方法增加了一个 getArray 参数来用于客户端回复对端 ACK,此版本中增加了 toArray 方法进行获取:
代码语言:javascript复制use SimpsMQTTMessage;
use SimpsMQTTProtocolProtocolInterface;
$message = new MessagePublish();
$message->setProtocolLevel(ProtocolInterface::MQTT_PROTOCOL_LEVEL_5_0)
->setTopic('simps/mqtt/message')
->setQos(ProtocolInterface::MQTT_QOS_1)
->setDup(ProtocolInterface::MQTT_DUP_0)
->setRetain(ProtocolInterface::MQTT_RETAIN_0)
->setMessage('this is content')
->setMessageId(1)
->setProperties(['message_expiry_interval' => 100]);
$array1 = $message->getContents(true);
$array2 = $message->toArray();
assert($array1 === $array2);
两者的结果相同。
- 优化 getProtocolLevel
MQTT5 协议中增加了一个 Properties
属性,而 MQTT3.x 中是没有的,之前的版本如果是 MQTT5 协议的话需要手动调用setProtocolLevel
来设置协议等级,此版本中就增加优化:判断是否设置了Properties
属性,如果设置了但协议等级不是 MQTT5 则自动设置为 MQTT5
- Message
use SimpsMQTTMessage;
use SimpsMQTTProtocolProtocolInterface;
$message = new MessagePublish();
$message->setTopic('simps/mqtt/message')
->setQos(ProtocolInterface::MQTT_QOS_1)
->setDup(ProtocolInterface::MQTT_DUP_0)
->setRetain(ProtocolInterface::MQTT_RETAIN_0)
->setMessage('this is content')
->setMessageId(1);
assert($message->isMQTT5() === false);
assert($message->getProtocolLevel() === ProtocolInterface::MQTT_PROTOCOL_LEVEL_3_1_1);
$message->setProperties(['message_expiry_interval' => 100]);
assert($message->isMQTT5() === true);
assert($message->getProtocolLevel() === ProtocolInterface::MQTT_PROTOCOL_LEVEL_5_0);
$message->setProtocolLevel(ProtocolInterface::MQTT_PROTOCOL_LEVEL_3_1);
assert($message->isMQTT5() === true);
assert($message->getProtocolLevel() === ProtocolInterface::MQTT_PROTOCOL_LEVEL_5_0);
- Config
use SimpsMQTTClient;
use SimpsMQTTConfigClientConfig;
use SimpsMQTTProtocolProtocolInterface;
$config = new ClientConfig();
$config->setClientId(Client::genClientID())
->setKeepAlive(10)
->setDelay(3000)
->setMaxAttempts(5)
->setProperties([
'session_expiry_interval' => 100,
])
->setSwooleConfig([
'open_mqtt_protocol' => true,
'package_max_length' => 2 * 1024 * 1024,
]);
assert($config->isMQTT5() === true);
assert($config->getProtocolLevel() === ProtocolInterface::MQTT_PROTOCOL_LEVEL_5_0);
更新日志
增强
- 添加 toArray 方法 (b3fd28a)
- 更新属性默认值 (9c63510)
- 添加遗嘱消息 Message 类 (#45)
- 添加 Auth Message 类 (36f6a9d)
- 增加 DUP、SESSION_PRESENT 和 RETAIN 的常量 (fe5c418)
- 优化 getProtocolLevel (a329202)
- 增加 isMQTT5 测试和使用常量代替硬编码(b9d4365)
修复
- 修正 ReasonCode 中错字 (481994f5)
关于 PHPMQTT
- 适用于 PHP 的 MQTT 协议解析和协程客户端
- 支持 MQTT 协议 3.1、3.1.1 和 5.0 版本,支持 QoS 0、QoS 1、QoS 2
- 首个支持 MQTT v5.0 协议的 PHP library
文档:https://mqtt.simps.io GitHub:https://github.com/simps/mqtt Gitee:https://gitee.com/phpiot/mqtt
支持记得点个 Star~
好文和朋友一起看~