Webman不能直接构建高并发直播平台全链路，因其默认启动HttpServer而非WebSocketServer，调用$app->on()会报错；直播流、实时指令等须交由Workerman WebSocket、FFmpeg等专用服务承担。
Webman 不能直接构建高并发直播平台的全链路，它只适合做业务网关和状态协调层；真正的直播流、实时指令、弹幕广播必须交给专用服务（Workerman WebSocket、FFmpeg、Redis Stream、SFU）来承担。
为什么 Webman 启动不了 WebSocket 服务？
因为 webman/start.php 默认启动的是 HttpServer，不是 WebSocketServer。你写 $app->on('message', ...) 会直接报错：Call to undefined method Webman\App::on()。
- 常见错误：把 Workerman 的
Worker::onMessage写法复制到 Webman 路由或中间件里 - 前端用
new WebSocket('ws://your-domain.com')直连 Webman 服务，返回400 Bad Request或立即断开 - 试图在
app/middleware里拦截upgrade请求但没实现 WebSocket 协议协商（缺少Sec-WebSocket-Key验签和101 Switching Protocols响应）
Webman 和 WebSocket 服务怎么共享用户身份？
PHP 的 $_SESSION 在长连接进程里不可用，也不能复用 Cookie 或 session 文件——WebSocket 进程不走 HTTP 生命周期。
Webman 2.2.0
下载
Webman 2.2.0版本强化了 TCP/UDP 服务支持，优化路由组管理，并增强异步任务处理能力。结合协程与连接池技术，Webman 能轻松应对高并发场景，适用于网站、接口服务、即时通讯、物联网及游戏开发，兼具高性能、灵活扩展与稳定可靠，是多场景 PHP 服务开发的理想选择。
- 前端建立连接时，必须显式透传凭证：例如
ws://localhost:2346?token=abc123 - WebSocket 服务（如
websocket.php）在onConnect回调里，同步调用 Webman 提供的鉴权接口（如http://127.0.0.1:8787/api/v1/auth/verify） - 校验通过后，把
user_id、room_id、role写入Swoole\Table或 Redis（推荐Redis::hSet('room:1001', 'user_234', 'teacher')） - 后续所有指令广播（如禁言、举手）只查本地内存表或 Redis，绝不每次
onMessage都远程鉴权
Webman 做弹幕网关时最容易卡住的点
它能收弹幕、过滤、写 Redis Stream，但一旦处理逻辑阻塞，整个连接就会拖慢——尤其在万人在线时。
- 敏感词过滤别每次都读文件或 DB，必须预加载到内存（如 Aho-Corasick 树），否则单次匹配耗时 >50ms 就会堆积
- 不要在
onMessage里直接调用$this->redis->xadd(...)，要确认 Redis 连接池已启用且max_idle_time设置合理（建议 60s），避免频繁重建连接 - 别让 Webman 承担弹幕广播职责：它只负责写
Redis Stream（如barrage:room_123），广播任务交给独立的 Go/Python 消费服务 - 静态资源（封面图、课件 PDF、HLS 分片）必须由 Nginx 直接
serve，绝不能走 Webman 路由，否则每个请求都触发完整 PHP 生命周期
课程模块路由设计不当会导致什么？
硬编码路由 + 堆条件判断，会让后续加功能（比如 AI 推荐、防刷课、多端来源标识）变得极其脆弱。
- 错误写法：
Route::get('/course/{id}', [CourseController::class, 'show'])，后面加?tab=outline&source=wechat就得在控制器里写一堆if判断 - 正确拆分：按场景设控制器——
CourseListController@index、CourseDetailController@show、LearningProgressController@update - 权限校验交给中间件，比如
/course/{course_id}/lesson/{lesson_id}配合CheckCourseAccessMiddleware，只查是否已购课，不写业务逻辑 - 路由参数别用
where做权限控制（->where('course_id', '\d+')只校格式，不校业务权限）
真正容易被忽略的是：Webman 的轻量和易上手，反而让人低估了直播场景下各模块的耦合深度——HTTP 网关、WebSocket 状态机、媒体流分发、缓存一致性，这四者之间只要一个环节没对齐（比如 Redis 过期时间比 token 短、Swoole\Table 内存溢出没监控），高并发时问题就不是“慢”，而是“大面积失联”。
