webman物联网tcp服务需五步实现：一定义含起始符、长度域、校验位的帧结构并实现编解码；二注册协议至tcp监听器；三通过心跳定时器管理连接生命周期；四用协程通道或redis pub/sub异步分发指令；五配置ssl/tls双向认证保障安全。
一、定义协议帧结构与编解码规则
Webman框架基于Swoole协程TCP服务器，需通过自定义FrameParser实现消息边界识别。协议设计应明确起始符、长度字段、校验位与结束符，避免粘包与拆包问题。编码需统一字节序（推荐大端），解码须严格校验长度域与CRC值。
1、在app/Protocol/CustomProtocol.php中创建类，继承Swoole\Network\Protocol或直接实现parse和pack方法。
2、parse()方法中读取前4字节作为包长（unpack('N', $buffer)），判断剩余缓冲区是否满足该长度；若不足，返回0等待更多数据；若满足，截取完整包并返回解析后的数组。
3、pack()方法将关联数组序列化为二进制：先写入4字节大端包长，再写入JSON编码的payload字节流，末尾追加0x00作为帧尾标识。
二、注册自定义协议至TCP监听器
Webman使用webman-swoole扩展启动TCP服务时，需显式绑定协议解析器。协议实例必须可被容器解析或以闭包方式传入，确保每个连接复用同一协议对象。
1、在config/bootstrap.php中引入协议类：use app\Protocol\CustomProtocol;
2、修改config/server.php中TCP类型监听配置，在'setting'下添加'open_eof_split' => false并移除默认分隔符设置。
3、于'onConnect'回调中调用$connection->setProtocol(new CustomProtocol())，或在server.php的'handler'键中传入new CustomProtocol()实例。
三、实现设备心跳与连接生命周期管理
TCP长连接需主动探测设备在线状态，防止因网络中断导致僵尸连接堆积。Webman不内置心跳机制，须结合onReceive事件与定时器手动维护连接健康度。
1、在app/Listener/TcpConnectionListener.php的onConnect方法中，为连接设置唯一ID并存入ConnectionPool静态数组，同时启动5秒间隔的心跳检测定时器。
Webman 2.2.0版本强化了 TCP/UDP 服务支持，优化路由组管理，并增强异步任务处理能力。结合协程与连接池技术，Webman 能轻松应对高并发场景，适用于网站、接口服务、即时通讯、物联网及游戏开发，兼具高性能、灵活扩展与稳定可靠，是多场景 PHP 服务开发的理想选择。
2、在onReceive中识别心跳包（如固定opcode=0x01），重置该连接的最后活跃时间戳，并清除对应定时器后重建。
3、定时器内检查当前连接的lastActiveTime是否超时（例如>30秒），若超时则调用$connection->close()并从连接池中移除该ID。
四、异步处理业务逻辑与设备指令分发
物联网场景中设备上报与平台下发需解耦，避免阻塞TCP事件循环。Webman支持协程通道与任务投递，应将耗时操作（如数据库写入、HTTP转发）移交TaskWorker或协程池执行。
1、在onReceive中解析出设备ID与指令类型后，立即向Channel推送结构化消息：['device_id' => 'abc123', 'cmd' => 'report', 'data' => $parsed]。
2、在app/Task/DeviceTask.php中定义handle方法，监听该Channel，对report类消息写入时序数据库，对control类消息构造响应帧并调用$connection->send()。
3、若需跨进程下发指令，改用Redis Pub/Sub：平台侧PUBLISH device:abc123 '{"cmd":"led_on"}'，各Webman Worker订阅device:*模式并匹配设备ID后执行下发。
五、启用SSL/TLS加密传输保障通信安全
物联网终端直连公网TCP服务时，明文传输存在密钥泄露与指令劫持风险。Webman可通过Swoole原生TLS支持启用双向认证，强制设备提供有效证书。
1、准备PEM格式证书链：fullchain.pem（含根CA与中间CA）、privkey.pem（服务端私钥）、ca.pem（客户端信任CA证书）。
2、在config/server.php中TCP监听配置下添加'ssl' => true，并在'setting'中指定：'ssl_cert_file' => runtime_path() . '/ssl/fullchain.pem'、'ssl_key_file' => runtime_path() . '/ssl/privkey.pem'、'ssl_cafile' => runtime_path() . '/ssl/ca.pem'。
3、设置'ssl_verify_client' => true开启双向验证，并在onConnect中调用$connection->getPeerCert()提取设备证书CN字段，校验其是否在白名单内；否则调用$connection->close()终止连接。
