PHPMQTT v1.3.1 版本发布，MQTT 协议解析 & 协程客户端

上个版本发布的知乎文章中有用户评论，遇到了握手失败的情况，联系了我之后进行了测试，我这里确实没问题，不过我删除了一段代码：

$will = [
    'topic' => '',
    'qos' => 0,
    'retain' => 0,
    'message' => '',
];
$client->connect(true, $will);

改为了直接进行connect

$client->connect();

由于使用的是 MQTT3，所以没有 MQTT5 中的 code 属性，需要通过抓包才可以获取到错误原因。

这里换为 MQTT5 之后就可以直接获取到错误原因，如以下代码就可以获取到错误原因

use Simps\MQTT\Client;
use Simps\MQTT\Config\ClientConfig;
use Simps\MQTT\Hex\ReasonCode;
use function Swoole\Coroutine\run;

run(function () {
    $config = new ClientConfig();
    $config->setUserName('')
        ->setPassword('')
        ->setClientId(Client::genClientID())
        ->setKeepAlive(10)
        ->setProtocolLevel(5)
        ->setDelay(3000) // 3s
        ->setMaxAttempts(5)
        ->setSwooleConfig([
            'open_mqtt_protocol' => true,
            'package_max_length' => 2 * 1024 * 1024,
        ]);

    $client = new Client('broker.emqx.io', 1883, $config);
    $will = [
        'topic' => '',
        'qos' => 0,
        'retain' => 0,
        'message' => 'byebye',
    ];
    $res = $client->connect(true, $will);
    var_dump($res, ReasonCode::getReasonPhrase($res['code']));
});

将 code 换为原因，就可以获取到错误原因为：Topic Name invalid

array(3) {
  ["type"]=>
  int(2)
  ["session_present"]=>
  int(0)
  ["code"]=>
  int(144)
}
string(18) "Topic Name invalid"

查看 MQTT 协议文档，会发现：

The Will Topic MUST be a UTF-8 Encoded String as defined

遗嘱消息中的 topic 不能为空，必须是一个有效的 UTF-8 字符串，长度大于 0

所以这里此版本中增加了限制，如果存在遗嘱消息，并且 topic 为空，则会直接抛出异常：

PHP Fatal error:  Uncaught Simps\MQTT\Exception\ProtocolException: Topic cannot be empty

更新日志

增强

• 增加 isMQTT5 方法 (f27f85c)
• 增加常量可见性 (#41)
• 为 getContents 方法添加 getArray 参数来用于客户端回复对端 ACK (#42)
• 添加 Message 测试 (8f7fe30)
• 更新 Message 文档 (a41654b)
• 更新 ProtocolException 并增加测试 (19a6bee)

修复

• 修复遗嘱消息的 topic 不能为空 (b56fda1)

关于 PHPMQTT

• MQTT 协议解析 & 协程客户端
• 适用于 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~