ThinkPHP6需借助Workerman实现在线客服实时交互，TP6负责业务逻辑与API，Workerman处理WebSocket连接与消息路由，Redis作为状态共享中枢；二者通过鉴权接口、消息存档、状态同步等机制协同工作。
ThinkPHP6.x 本身不内置长连接支持，要实现在线客服这类实时交互功能，必须借助外部常驻进程服务（如 Workerman）来处理 WebSocket 连接与消息转发。核心思路是：ThinkPHP 负责业务逻辑（用户管理、会话记录、工单、后台管理），Workerman 独立运行 WebSocket 服务处理客户端连接、心跳、消息路由；两者通过 Redis（或数据库）共享状态、同步数据。
一、环境准备与基础架构设计
确保服务器已安装 PHP（建议 7.4+）、Redis（用于连接映射、离线消息、会话状态）、Composer。项目结构建议分离：
- ThinkPHP6 应用目录（
tp6/）：提供 REST API（登录、获取客服列表、提交咨询、查询历史）、WebSocket 鉴权接口、消息存档逻辑 - Workerman 服务目录（
workerman/）：独立启动，监听 WebSocket（如wss://your.com:2346），不依赖 TP6 的 HTTP 生命周期 - 共用配置：Redis 地址、JWT 密钥、客服分组规则等需在两套环境中一致
二、Workerman WebSocket 服务搭建要点
使用 workerman/workerman + workerman/websocket 扩展。关键实现包括：
-
连接鉴权：客户端连接时携带 token（由 TP6 登录后签发），Workerman 向 TP6 提供的
/api/ws/auth接口发起 POST 请求验证身份与角色（访客/客服/管理员） -
连接绑定：成功后将
connection->id与用户 ID、角色、所属客服组写入 Redis Hash（如ws:conn_map:{uid}），并设置过期时间（如 2 小时） -
消息路由：收到消息后解析目标类型（单聊/群聊/转接），查 Redis 获取接收方当前连接 ID 列表，调用
$connection->send()或广播；若对方离线，存入 Redis List（ws:offline:{to_uid}）并触发 TP6 的离线推送任务 -
心跳保活：启用
ping_interval和ping_data，客户端每 30 秒发 ping，服务端自动回 pong；超时未响应则主动 close 并清理 Redis 中的连接记录
三、ThinkPHP6 侧关键对接逻辑
TP6 不参与连接维持，但需提供以下能力支撑整个客服流程：
立即学习“PHP免费学习笔记（深入）”；
-
WebSocket 鉴权接口（
POST /api/ws/auth）：校验 token 有效性、检查用户是否被禁用、返回客服分组 ID 或分配策略（如轮询/指定） -
消息存档接口（
POST /api/message/store）：Workerman 在消息成功投递后（或离线入库时）调用，保存文本、文件 URL、发送方/接收方 ID、时间戳、会话 ID（可按访客手机号 + 客服 ID 组合生成） -
客服状态同步：客服在 TP6 后台点击“上线/离线”时，更新 Redis 中的
staff:status:{staff_id}，Workerman 定时扫描该 key 并通知在线访客界面刷新客服列表 - 文件上传适配：访客上传图片/文件，TP6 接收后存至对象存储（如 OSS/COS），返回可访问 URL；该 URL 作为消息体字段传给 Workerman，再推送给客服端
四、安全与稳定性增强建议
生产环境不可忽略以下细节：
- Workerman 进程必须以非 root 用户运行，WebSocket 端口（如 2346）避免低于 1024；反向代理（Nginx）需开启 WebSocket 支持：
proxy_http_version 1.1、proxy_set_header Upgrade $http_upgrade - 限制单 IP 连接数（
$worker->count = 1000）、单连接消息频率（用 Redis 计数器防刷），敏感操作（如转接、强制下线）需二次校验权限 - 所有客户端到 Workerman 的通信必须走 WSS（TLS 加密），token 有效期建议 24 小时，且每次重连重新校验
- 部署多实例 Workerman 时，必须依赖 Redis 实现跨进程连接发现与消息广播，不能使用默认的 file 或 memory driver
不复杂但容易忽略。Workerman 是管道，ThinkPHP6 是大脑，Redis 是神经中枢——三者职责分明，才能让客服系统稳定扛住并发、消息不丢、状态实时。
