php 8.6向mqtt broker发布qos 1消息时,发送publish()后还需运行事件循环处理puback,再断开连接。qos 1表示至少一次投递,接收方仍要处理重复消息;它不能替代业务处理成功的应用层回执。

官方文档:Publish
安装客户端并准备TLS端点
composer require php-mqtt/client:^2.3 composer check-platform-reqs
由Broker管理员提供TLS主机名、端口、可信CA和受限发布账号。下面以常见8883端口示例,实际使用服务器配置值;不能通过关闭对端验证来绕过证书错误。

官方文档:Connection Settings
等待应答后断开
<?php
require __DIR__ . '/vendor/autoload.php';
use PhpMqtt\Client\MqttClient;
use PhpMqtt\Client\ConnectionSettings;
$settings = (new ConnectionSettings())
->setUsername(getenv('MQTT_USER'))
->setPassword(getenv('MQTT_PASSWORD'))
->setUseTls(true)
->setTlsVerifyPeer(true)
->setTlsVerifyPeerName(true)
->setConnectTimeout(5);
$mqtt = new MqttClient(getenv('MQTT_HOST'), 8883, 'php-export-' . bin2hex(random_bytes(4)));
$mqtt->connect($settings, true);
try {
$payload = json_encode(['event_id' => 'export-42', 'state' => 'ready'], JSON_THROW_ON_ERROR);
$mqtt->publish('app/exports/status', $payload, 1, false);
$mqtt->loop(true, true, 10);
} finally {
$mqtt->disconnect();
}第三个loop参数限制等待时长。网络超时或客户端异常应作为结果不确定处理,不能只因为publish()调用返回就标记接收方已完成业务。retain设为false,避免把本次事件当作主题的长期保留状态。
区分传输确认和业务确认
测试时让受限订阅账号监听同一主题,核对event_id与内容。发送端超时重试可能导致重复,消费端按稳定event_id去重;需要端到端结果时设计独立回执主题。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
账号ACL仅允许发布所需主题。持久会话、离线消息和QoS 2需要额外的存储与会话约定,不能把本例的随机客户端ID直接用于需要持续恢复订阅的消费者。
立即学习“PHP免费学习笔记(深入)”;


















