PHP无法用$_POST或file_get_contents接收MQTT消息，因MQTT是基于TCP的长连接异步协议，需主动作为客户端连接broker订阅主题；必须用CLI常驻进程配合php-mqtt/client库实现稳定收发。
PHP 本身不支持原生 MQTT 连接，必须依赖第三方客户端库；直接用 file_get_contents('php://input') 或普通 HTTP 接收方式无法对接 MQTT 设备——因为 MQTT 是长连接、异步、基于 TCP 的协议，不是请求-响应模型。
为什么不能用 $_POST 或 file_get_contents 接收 MQTT 消息
MQTT 设备（如 ESP32、树莓派）发布消息到 broker（如 Mosquitto、HiveMQ），PHP 不是“被动接收方”，而是要主动作为 MQTT 客户端去连接 broker、订阅主题、监听回调。HTTP 接口只能响应一次请求，而 MQTT 消息是持续、无请求触发的推送流。
常见错误现象：
- 写了个 PHP 脚本监听
/api/sensor，但 MQTT 设备发的数据根本没到这个 URL —— 因为设备根本没走 HTTP - 用
curl手动往 broker 发消息能收到，但 PHP 脚本跑几秒就退出，$mqtt->loop(true)没生效 —— PHP 默认执行完就结束，没做常驻进程管理 - 本地测试连
broker.hivemq.com成功，一上生产环境就超时 —— 防火墙或云服务器安全组没放开1883端口，或 broker 未启用匿名访问
用 php-mqtt/client 连接 broker 并稳定收消息
推荐使用维护活跃的 php-mqtt/client（非已停更的 bluerhinos/phpmqtt），它支持 QoS、遗嘱消息、TLS，并兼容 PHP 8+。
立即学习“PHP免费学习笔记（深入）”；
安装与基础连接：
composer require php-mqtt/client
关键实操点：
- 必须调用
$mqtt->connect()，且传入的$clientId要唯一（建议含时间戳或随机串），否则 broker 可能踢掉旧连接 -
$mqtt->subscribe()第三个参数是 QoS，生产环境别硬写0；若设备关键数据（如告警）需确保到达，至少设为1 -
$mqtt->loop(true)是阻塞式长循环，不能放在 Web 请求里跑 —— 必须用 CLI 方式启动，例如：php mqtt_listener.php - 加
pcntl_signal()捕获SIGINT实现优雅退出，避免强制 kill 导致连接残留
如何让 PHP MQTT 进程不挂、不断、不丢消息
CLI 脚本跑着跑着退出，或断网后不重连，是物联网后端最常踩的坑。核心不在“连上”，而在“连得稳”。
必须处理的几个环节：
- 网络异常时，
$mqtt->isConnected()会返回false，需在loop中定期检查，失败后 sleep 几秒再reconnect() - 不要把业务逻辑（如写 MySQL）写在订阅回调里太久，否则阻塞
loop，导致心跳超时断连；应把消息推到Redis或本地队列，另起 worker 处理 - 启用 broker 的
clean session = false+ 客户端设置will（遗嘱消息），设备离线时能通知系统 - 用
systemd或supervisord管理进程，禁止直接后台运行nohup php xxx &—— 没崩溃监控、无日志轮转、重启后不自动拉起
传感器数据进 PHP 后怎么安全解析和落地
收到的 $message 是原始字节流，不是自动 JSON 解码后的数组。你得自己判断格式、校验结构、防注入。
典型处理链路：
- 先检查
$topic是否匹配预期（如sensor/+/temperature），避免误收其他设备消息 - 用
json_decode($message, true)解析，立刻检查json_last_error() === JSON_ERROR_NONE，否则丢弃并记录告警 - 关键字段（
device_id、value、timestamp）必须存在且类型合法，比如is_numeric($data['value']) - 写数据库前，优先用
PDO::prepare()绑定参数，别拼 SQL；高频场景改用INSERT ... ON DUPLICATE KEY UPDATE防重复
真正难的不是“收到数据”，而是当 500 台设备每秒各发一条，PHP 进程是否还在线、消息是否顺序错乱、某台设备断电后历史消息能否补推——这些细节不提前设计，上线三天就救火。
