Workerman 4.0.34 下搭建实时白板需四步：① 启用 $worker->count = 4 并加载 autoload.php；② 结构化 JSON 消息协议与增量同步；③ 绑定 room_id/user_id 实现房间隔离与内存清理；④ 连接级防抖限频（20fps）。
要在 Workerman 4.0.34 环境下搭建支持多人实时协作的在线教育互动白板，核心是让笔迹、选中、擦除等操作在所有客户端间毫秒级同步，且不因连接中断丢失状态。
初始化 WebSocket 白板服务端
创建 whiteboard_server.php，使用 Workerman 4.0.34 的 WebSocket 协议监听端口，必须启用 【$worker->count = 4】 启动多个工作进程，单进程无法承受 50+ 并发绘图请求；若漏设，用户稍一密集操作就会卡顿甚至断连。
require_once __DIR__ . '/vendor/autoload.php';
use Workerman\Worker;
$ws_worker = new Worker('websocket://0.0.0.0:8081');
$ws_worker->count = 4;
这一步不能省略 autoload.php，否则 Connection 类无法自动加载，后续所有 send() 调用都会报 Fatal Error。
定义白板消息协议与广播逻辑
白板不是简单转发字符串，必须结构化处理三类操作：draw（贝塞尔路径点）、select（选中对象 ID）、erase（擦除区域坐标）。所有消息统一走 JSON 格式，避免客户端解析歧义。
方法一：基础广播（适合小班课）
$ws_worker->onMessage = function ($connection, $data) use ($ws_worker) {
$msg = json_decode($data, true);
if (!$msg || !isset($msg['type'])) return;
foreach ($ws_worker->connections as $client) {
if ($client !== $connection) {
$client->send(json_encode($msg));
}
}
};
方法二：带状态快照的增量同步（推荐用于 20 人以上课堂）
在 onMessage 中增加判断：若 msg['type'] === 'sync'，则只向新连接的客户端发送当前白板完整图层数组（含每个图形的 id、type、points、color），其余操作仍走增量广播。否则新用户加入时看到的是空白画布。
实现客户端连接身份绑定与房间隔离
第一步：客户端连接时必须携带 room_id 和 user_id，例如 ws://localhost:8081?room_id=math202608&user_id=stu_789。
第二步：在 onConnect 回调中解析 URL 参数，将 connection 绑定到内存中的房间哈希表：
$connection->room_id = $request->get('room_id', 'default');
$connection->user_id = $request->get('user_id', 'guest_' . uniqid());
第三步：修改 onMessage 中的广播目标——不再遍历全部 connections，而是只遍历 【$ws_worker->rooms[$connection->room_id] ?? []】 内的连接。这一步不做，不同课程的老师和学生会互相看到对方的笔迹。
第四步：在 onConnect 末尾执行 $ws_worker->rooms[$connection->room_id][] = $connection；在 onClose 中用 array_filter 清理对应 room_id 下的连接，否则内存泄漏会在 2 小时后触发 OOM。
添加防抖与限频保护
用户快速拖动画笔时，每毫秒可能产生 10+ 点位消息。直接转发会导致带宽暴涨、客户端渲染卡死。必须在服务端做节流：
① 在 connection 对象上挂载 last_draw_time 时间戳；
② 收到 draw 类型消息时，检查 time() - $connection->last_draw_time ③ 每次通过校验后更新 $connection->last_draw_time = time();
这个阈值设为 0.05 秒（即最多 20fps），既能保证书写流畅，又可过滤掉 90% 的冗余点位。设得更低会糊成一片；设得更高则线条锯齿明显。
不需要额外安装 Redis 或数据库，纯内存操作即可支撑 200 人以内白板协作。
