FrankenPHP本身不提供前端事件类型区分机制，其作用是作为PHP应用服务器提供API、SSE或WebSocket等后端接口；前端需通过SSE的event字段、JSON响应中的type/event字段或自定义WebSocket消息结构来识别和分发业务事件，且必须前后端严格约定并校验事件命名。
FrankenPHP 本身不提供前端事件类型区分机制——它是个 PHP 应用服务器，不直接暴露或管理浏览器端的 DOM 或自定义事件。所谓“前端区分事件类型”，实际是指：你用 FrankenPHP 提供的后端接口（如 API、SSE、WebSocket 封装、或普通 HTTP 响应）返回数据后，前端 JavaScript 如何识别和处理不同语义的事件。
如何让前端识别后端推送的事件类型（如 SSE）
SSE（Server-Sent Events）是 FrankenPHP 中最常用、最轻量的实时事件通道。它依赖 HTTP 响应头 Content-Type: text/event-stream 和标准事件字段（event:、data:、id:）。前端靠 event 字段值做路由分发。
- 后端 PHP 脚本（如
/events.php）需输出带event:前缀的行：event: user_login data: {"user_id": 123, "at": "2026-10-13T08:56:00Z"} event: payment_success data: {"order_id": "ORD-789", "amount": 99.99} - 前端
EventSource实例必须为每个event:值显式绑定处理器：const es = new EventSource('/events.php'); es.addEventListener('user_login', e => console.log('✅ 登录事件:', JSON.parse(e.data))); es.addEventListener('payment_success', e => console.log('? 支付成功:', JSON.parse(e.data))); // 注意：不监听的 event 类型会被忽略，不会触发 onmessage - 别漏掉
event:后面的空格——规范要求冒号后必须跟一个空格，否则浏览器可能丢弃整条消息 - FrankenPHP 默认支持 SSE，但需确保响应未被中间件（如 Caddy 的 gzip）截断或缓冲；在
.frankenphp.router.php中建议加header('X-Accel-Buffering: no');
为什么不能靠响应状态码或 Content-Type 区分业务事件
HTTP 状态码（如 200、409）和 Content-Type 是协议层信号，表达的是传输/处理状态，不是业务语义。把“订单创建失败”映射到 400 Bad Request 是合理设计，但把“用户已上线”也塞进 409 Conflict 就会混淆职责。
前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。
-
4xx/5xx应只用于客户端错误或服务不可用等可恢复/需告警场景，不应承载业务分支逻辑 - 前端若用
fetch()轮询 JSON 接口，所有成功响应的Content-Type都是application/json，无法靠它区分“消息通知”和“配置更新” - 真正可靠的区分方式，是在响应体（JSON）中显式携带
type字段：{"type": "notification", "payload": {...}} {"type": "config_update", "version": "2.1"} - 前端统一解析
response.type再分发，比维护一堆不同 endpoint 或状态码更易扩展和调试
WebSocket 场景下事件类型怎么约定
FrankenPHP 不内置 WebSocket 服务，但可通过 frankenphp-worker 启动一个长连接 PHP 进程，用 stream_socket_*() 手动实现。此时事件类型完全由你定义的二进制或文本协议决定。
立即学习“PHP免费学习笔记（深入）”；
- 推荐用简单 JSON 消息格式，强制含
event字段：{"event": "chat_message", "from": "alice", "text": "hi"} {"event": "typing_start", "user": "bob"} - 避免用数字 code（如
{"code": 101}），前端得硬编码映射表，后期难维护 - 服务端发送前务必调用
json_encode()并检查json_last_error()—— FrankenPHP 的 worker 模式对输出容错低，非法 JSON 会导致连接静默断开 - 前端收到消息后，先
JSON.parse()，再switch (data.event)分支，不要假设字段一定存在（加?.event ?? 'unknown'）
最容易被忽略的一点：无论用 SSE、轮询还是 WebSocket，事件类型的定义和校验必须前后端对齐，且写进接口文档。FrankenPHP 不帮你做 schema 验证，也不会自动转换 user_login 和 userLogin——大小写、下划线、命名空间全靠人工约定，出错时前端只会收空消息或解析异常。
