Workerman做物联网平台教程:MQTT与TCP长连接方案
Workerman虽非开箱即用的MQTT服务器,却凭借PHP罕见的真正异步TCP能力,成为支撑万级物联网设备长连接的高性价比接入网关方案;但成功落地的关键在于深入理解MQTT协议状态机(CONNECT/PING/STATE)、严格实现二进制报文解析、依托Redis协同管理会话与QoS1消息、按Topic精准路由而非全量广播,并规避多进程内存不共享、同步IO阻塞、TIME_WAIT堆积等典型陷阱——稍有疏漏,轻则连接频繁重置、指令丢失,重则CPU飙升、服务雪崩。

Workerman 能不能扛住万级 MQTT 设备长连接
能,但不是直接跑 MQTT 协议——Workerman 本身不解析 MQTT 报文,得自己实现或套一层 php-mqtt/server 这类库。它的优势是 PHP 少有的真正异步长连接能力,适合做 TCP 层的设备接入网关,但别指望它像 EMQX 那样开箱即用。
常见错误现象:connection reset by peer 频发、心跳超时后连接不释放、设备重连时旧连接残留;根本原因是没处理好 MQTT 的 CONNECT/CONNACK/PINGREQ/PINGRESP 状态机,只做了裸 TCP 转发。
- 必须自己维护连接状态(client_id、clean session、will message),PHP 没原生 MQTT 会话管理
- 心跳检测不能只靠 TCP keepalive,得解析 MQTT PING 包并主动回复
PINGRESP - 消息路由要按 topic 做内存级分发,别一来 publish 就全广播——否则 5000 设备连上来,一条群控指令就 CPU 拉满
用 Workerman 写 MQTT 接入层的关键三步
不是写个 onMessage 就完事。真实设备接入要过三关:协议解析、会话绑定、上下行分流。
使用场景:温湿度传感器定时上报、PLC 下发控制指令、固件远程升级通知下发。
- 第一步:用
binaryProtocol+ 自定义decode/encode处理 MQTT 固定头和可变头,别用json_decode硬解——MQTT 报文是二进制流,CONNECT包里的 protocol name 是 0x00 0x04 ‘M’ ‘Q’ ‘T’ ‘T’,不是字符串 - 第二步:在
onConnect里根据 client_id 查 Redis,恢复上次会话(如果 clean_session = false),并把$connection->session设为关联数组存 qos、topic filter 等 - 第三步:收到
PUBLISH后,用preg_match或前缀树(如php-trie)匹配订阅关系,只推给匹配的 connection,避免全量遍历
为什么别在 Workerman 里直接存设备数据
Workerman 进程间内存不共享,$_SESSION 或全局数组在多进程下完全不可靠。设备状态、最后上线时间、未确认 QoS1 消息这些,必须落地到外部存储。
性能影响:如果在 onMessage 里同步写 MySQL,单条 PUBLISH 延迟从毫秒级变成百毫秒级,设备端会因超时反复重发。
- 设备在线状态用 Redis 的
SET device:xxx online EX 60 NX+ 定时任务扫描过期 key - QoS1 的 PUBACK 未收到,要把 msg_id 存 Redis Sorted Set,score 设为超时时间戳,另起一个
Timer::add定期扫 - 千万别用
file_put_contents记日志——高并发下文件锁会让所有 worker 卡住
TCP 长连接下 Workerman 的真实瓶颈在哪
不是 CPU,也不是内存,是 Linux 内核的 socket 数量限制和 TIME_WAIT 连接堆积。设备频繁断连重连时,netstat -ant | grep TIME_WAIT | wc -l 很容易破万。
兼容性影响:PHP 8.1+ 的 stream_socket_server 默认开启 SO_REUSEPORT,但 Workerman 2.x 不支持,得升到 4.x 或手动 patch。
- 调大
net.ipv4.ip_local_port_range和net.ipv4.tcp_fin_timeout,否则新连接建不起来 - 客户端必须带
keepalive(比如 60 秒),服务端在onClose里别直接 unset connection,先标记为 closing 等心跳超时再清理 - Workerman 的
reload会杀掉所有连接,设备无感知断连;要用gracefulStop+ 反向代理(如 Nginx)做连接漂移
复杂点在于 MQTT 协议状态和 Workerman 生命周期不耦合——一个连接可能经历多次重连、clean session 切换、topic 订阅变更,这些都得在内存+Redis 之间小心对齐,漏一步,设备就收不到指令或者重复上报。
好了,本文到此结束,带大家了解了《Workerman做物联网平台教程:MQTT与TCP长连接方案》,希望本文对你有所帮助!关注golang学习网公众号,给大家分享更多文章知识!
Linux下部署Docker容器及运行应用教程
- 上一篇
- Linux下部署Docker容器及运行应用教程
- 下一篇
- Python处理数字列表的实用函数有哪些
-
- 文章 · php教程 | 13小时前 |
- PHPUnit DataProvider 怎样为同一测试准备多组输入
- 365浏览 收藏
-
- 文章 · php教程 | 13小时前 |
- PHP ReflectionExtension getINIEntries 怎样读取扩展配置项
- 242浏览 收藏
-
- 文章 · php教程 | 14小时前 |
- PHP ldap_escape 怎样正确转义 LDAP 过滤器条件
- 147浏览 收藏
-
- 文章 · php教程 | 14小时前 | 测试 · 随机数 · PHP · php 随机数 可测试性 依赖注入 Randomizer Random Engine
- PHP Random\Randomizer 怎样注入可测试的随机源
- 153浏览 收藏
-
- 文章 · php教程 | 14小时前 | 错误处理 · php教程 · php 并发请求 curl_multi_exec curl_multi_info_read CURLMSG_DONE CURLE_OK CurlHandle
- PHP curl_multi_info_read 读取已完成请求结果的处理方法
- 156浏览 收藏
-
- 文章 · php教程 | 14小时前 | PHP · 时间处理 · php DateTime 时区 修改时间 DateTimeZone 创建时间 DateTimeImmutable
- PHP DateTime 怎样处理创建时间和修改时间的时区
- 458浏览 收藏
-
- 文章 · php教程 | 14小时前 |
- PHP 8.4 Lazy Objects 怎样延迟初始化对象属性
- 189浏览 收藏
-
- 文章 · php教程 | 14小时前 |
- PHP 8.4 #[Deprecated] 怎样标记待移除 API
- 221浏览 收藏
-
- 文章 · php教程 | 1天前 | 文件读取 · PHP · php SplFileObject fgets setMaxLineLen
- PHP SplFileObject.setMaxLineLen 怎样限制单行读取长度
- 489浏览 收藏
-
- 文章 · php教程 | 1天前 | 缓存 · 性能 · php教程 · php 缓存更新 OpCache PHP部署 opcache.validate_timestamps opcache.revalidate_freq
- PHP OPcache.validate_timestamps 怎样理解部署后的缓存更新
- 190浏览 收藏
-
- 文章 · php教程 | 1天前 | PHP · php DatePeriod include_start_date 日期迭代
- PHP DatePeriod::include_start_date 怎样决定首个日期是否参与迭代
- 419浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- PubMedQA
- 深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
- 1147次使用
-
- H2O EvalGPT
- H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
- 1134次使用
-
- LMArena
- LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
- 1312次使用
-
- HELM
- 深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
- 1251次使用
-
- MMBench
- MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
- 1103次使用
-
- PHP fgetcsv escape 参数显式设置与 RFC 4180 兼容处理
- 2026-10-26 501浏览
-
- PHP JSON_THROW_ON_ERROR 抛错后怎么保留原始字段位置
- 2026-09-09 501浏览
-
- PHP 8.5 array_last() 怎么处理空数组:从 null 结果到兼容旧版本的 Polyfill
- 2026-08-16 501浏览
-
- 宝塔配置Ruby环境:RVM+Nginx反代教程
- 2026-05-29 501浏览
-
- unset函数作用范围详解
- 2026-05-29 501浏览

