如何使用Webman构建在线协作文档后端-php教程-PHP中文网

webman协作文档后端核心是避免状态错乱：websocket不可用$_session，须用token绑定user_id；文档必须带version字段实现乐观锁；http与websocket须共享documentstore统一状态。

如何使用webman构建在线协作文档后端

Webman 构建在线协作文档后端，核心不是“实时同步有多快”，而是「如何避免状态错乱」——WebSocket 连接不共享 session、静态变量在常驻进程中跨请求污染、JSON Patch 或 OT 操作没做并发校验，这三个点踩中任意一个，协作就会出现内容覆盖或版本回滚。

Webman 的 WebSocket 服务运行在独立进程，不经过 PHP-FPM，$_SESSION 完全不可用。常见错误是直接在 onMessage 里调 session_start() 或读 $_SESSION['user_id']，结果永远为空。

改用 token 校验：前端连接时在 query string 带 ?token=xxx，服务端用 $connection->getRemoteAddress() + $connection->getArgs() 提取并验证 JWT
把用户身份存到连接对象上：$connection->user_id = $uid;，后续所有操作都基于这个字段做权限和隔离
别把用户信息塞进 self::$docs 数组键名（如 self::$docs["{$doc_id}_{$user_id}"]），容易内存泄漏；应统一用文档 ID 隔离，权限由操作时校验

多个客户端同时编辑同一文档时，靠“最后写入获胜”会丢数据。self::$docs[$doc_id]['version'] 不是可选优化项，是必需字段。

Webman 2.2.0

Webman 2.2.0版本强化了 TCP/UDP 服务支持，优化路由组管理，并增强异步任务处理能力。结合协程与连接池技术，Webman 能轻松应对高并发场景，适用于网站、接口服务、即时通讯、物联网及游戏开发，兼具高性能、灵活扩展与稳定可靠，是多场景 PHP 服务开发的理想选择。

下载

每次 onMessage 收到操作前，先比对客户端传来的 version 和当前服务端 self::$docs[$doc_id]['version']
不一致就立刻返回 { "type": "rebase", "snapshot": "...", "version": N }，强制前端拉取最新快照重放操作
成功应用操作后，必须原子递增 self::$docs[$doc_id]['version']++，不能用 += 1（协程环境下可能丢失）
不要用时间戳替代 version —— 高并发下毫秒级时间戳会重复，无法保证单调递增

用户通过 HTTP GET /api/doc/123 查看文档，和通过 WebSocket 编辑同一份文档，如果两者读写不同变量或缓存，必然出现数据不一致。

把 self::$docs 抽成独立的 DocumentStore 类，提供 get($id)、update($id, $ops, $version) 等方法，HTTP 控制器和 WebSocket 回调都调它
DocumentStore 内部用 Swoole\Table 替代普通数组，支持多进程安全读写（Webman 默认启用多 worker 进程）
HTTP 接口返回文档时，必须带上当前 version 字段，前端保存用于下次 WebSocket 操作校验
禁止在 HTTP 接口里直接 file_get_contents("doc_123.json") —— 文件 I/O 会阻塞协程，且无法与 WebSocket 内存状态同步

真正难的不是实现“谁改了哪一行”，而是让 HTTP 请求、WebSocket 消息、定时自动保存、甚至离线补发操作，全部落在同一个状态机上。version 字段漏校验、存储没抽象、连接身份没绑定——这三处一旦松动，协作就退化成单人编辑器。