Webman是基于Workerman的PHP高性能框架，非Java框架；其核心依赖异步非阻塞I/O、多进程事件驱动、常驻内存、模块化分层及连接复用五大架构设计。
Webman 不是 Java 框架，也不是基于 JDK 的运行时环境——它是一个 PHP 框架，由 Workerman 团队开发，底层完全复用 Workerman 的异步事件驱动能力。所有把 Webman 当成 Java 框架、引用 cd.salt.webman 或 com.github.wnameless.webman 的代码示例，都是混淆或错误的，无法运行。
确认 Webman 的真实技术栈
Webman 是 PHP 生态中对标 Laravel/Swoole 的轻量级高性能 Web 框架，其 WebSocket 支持直接依赖 Workerman 的 Worker 和 Connection\TcpConnection，不经过 HTTP 中间层，也不依赖 Java 环境或 Maven 构建。
- 必须使用 PHP 7.4+（推荐 8.1+），且启用
pcntl、posix、sockets扩展 -
composer create-project webman/console是标准初始化方式，不是 Mavenpom.xml - WebSocket 路由注册在
config/route.php中，通过Webman\Route::websocket()声明 - 实际处理类继承
Webman\WebSocket\Connection，不是WebsocketHandler或WebSocketHandler
WebSocket 连接管理必须用全局连接池，不能靠 session 或内存数组
Workerman/Webman 的每个 worker 进程是独立内存空间，$clients = [] 这种写法只在当前进程有效，多进程下广播会丢失 75% 的消息。正确做法是用 Worker::$connections（它自动跨进程同步连接句柄）或引入 Redis pub/sub 做消息中转。
WebSocket 8.18.2 是该协议规范的一个重要迭代版本，主要优化了连接稳定性与数据传输效率。它通过全双工通信机制，允许客户端与服务器在单一长连接上实时交换数据，大幅降低传统 HTTP 轮询的开销。该版本增强了心跳保活、自动重连及二进制帧传输能力，适用于即时通讯、在线游戏及金融行情推送等低延迟场景，为开发者提供更可靠的实时网络交互基础。
- 广播消息必须遍历
$connection->worker->connections，而不是自定义数组 - 用户身份绑定不能只靠
$connection->session()->set('uid', 123)，因为 session 默认基于文件，不共享；应改用$connection->uid = 123并配合onConnect中持久化到 Redis - 连接断开时，
onClose回调里要显式清理 Redis 中的在线状态，否则会出现“假在线”
onMessage 中禁止阻塞操作和未捕获异常
WebSocket 回调函数一旦抛出未捕获异常，整个 worker 进程会退出，导致部分连接静默掉线，现象是：新用户连不上、老用户收不到消息、日志里无报错——只有 php workerman start -d 后看 workerman.log 才能看到 Fatal error: Uncaught Exception。
- 所有数据库查询、Redis 调用必须用异步客户端（如
co\Redis或swoole_redis），不能用mysqli或PDO - JSON 解析前先检查
is_string($data) && !empty($data)，防止前端发 null 或空字符串触发json_decode(null)返回 null 导致后续逻辑崩坏 - 敏感词过滤、消息长度截断等逻辑建议前置到
onMessage开头，失败直接$connection->close()，避免污染广播流
生产环境必须加 SSL 和反向代理层
浏览器强制要求 wss://（而非 ws://）才能在 HTTPS 页面中建立 WebSocket 连接。直接让 Webman 监听 443 端口做 TLS 是低效且危险的——Workerman 不适合做证书卸载。
- Nginx 必须配置
proxy_pass到后端http://127.0.0.1:8787（Webman 默认 HTTP 服务端口），并透传Upgrade和Connection头 - WebSocket 路径需与 Nginx
location严格一致，例如 Webman 定义/ws，Nginx 就不能配成/websocket，否则握手 404 - 务必设置
proxy_read_timeout 60，否则 Nginx 默认 60 秒无数据会主动断连，导致心跳失效
最易被忽略的一点：Webman 的 WebSocket 连接对象没有内置心跳保活，浏览器休眠或 NAT 超时会导致连接僵死。你得自己在 onConnect 里启动定时器，每 25 秒发一次 ping 帧，并在 onMessage 中识别 pong 响应，否则上线三天后在线人数虚高、消息延迟飙升。
