FrankenPHP Mercure推送延迟监控需组合日志、时间戳与外部验证：PHP端在frankenphp\publish()前用microtime(true)打点并控制cURL超时，消息payload中嵌入server_ts_ms，前端用Date.now()减去该值计算端到端延迟，同时启用Caddy mercure metrics暴露publish_duration等指标观测Hub积压。
FrankenPHP 本身不提供 Mercure 消息投递延迟的内置监控指标，必须靠日志 + 时间戳 + 外部验证组合实现。 它把推送逻辑下沉到 Caddy 的 Mercure Hub 层，PHP 层只负责调用 frankenphp\publish()，而“发没发出去”“客户端多久收到”“有没有丢”全在 Hub 和网络链路里——你得自己埋点、对时、抓包、比对。
怎么在 PHP 发布端记录投递时间戳
延迟监控的第一环是“发出时刻”。不能依赖 time() 或 microtime(true) 直接打点，因为 frankenphp\publish() 是异步 HTTP 请求，实际发送可能被 DNS 解析、连接复用、TLS 握手拖慢。正确做法是：在调用前记录毫秒级时间，并显式控制 cURL 行为。
- 用
microtime(true)在frankenphp\publish()调用前打点，存入任务上下文（如 Redis hash 或日志行） - 禁用 cURL 的默认重试和长连接：
CURLOPT_CONNECTTIMEOUT_MS = 300、CURLOPT_TIMEOUT_MS = 200、CURLOPT_FORBID_REUSE = true - 记录 cURL 返回的
curl_getinfo($ch, CURLINFO_STARTTRANSFER_TIME)，这才是真正开始传输数据的时间 - 如果
frankenphp\publish()抛异常或返回 false，立刻标记为“投递失败”，不要等前端反馈
怎么验证浏览器端真实接收延迟
EventSource 收到消息的时间 ≠ 服务端发出时间，中间隔着 Mercure Hub 转发、Caddy 中间件、HTTP/2 流控、浏览器解析开销。你无法直接从 JS 获取服务端时间戳，必须让服务端把时间带上。
- 发布消息时，在 payload 里硬编码服务端时间：
"server_ts_ms" => round(microtime(true) * 1000) - 前端 EventSource 的
message事件处理器里，用Date.now()减去event.data.server_ts_ms，得到端到端延迟（单位毫秒） - 注意：前后端时钟需 NTP 同步，误差超过 500ms 就失去监控意义；开发环境可用
date -s "$(curl -s --head http://google.com | grep '^Date:' | sed 's/Date: //g')"粗略校准 - 别信
event.timeStamp—— 它是浏览器事件队列入队时间，不是接收时间
怎么识别 Mercure Hub 层的积压或阻塞
404 或 500 错误只是“不可用”，真正的延迟黑洞藏在 Hub 内部队列。FrankenPHP 不暴露 Hub 队列长度，但你可以用 Caddy 的 mercure 块配置 + Prometheus 暴露指标来间接观测。
立即学习“PHP免费学习笔记（深入）”；
- 在 Caddyfile 的
mercure块中启用metrics指令：metrics /metrics（需 Caddy v2.7+） - 启动时挂载 Prometheus exporter（如
caddy-prometheus插件），抓取mercure_hub_publish_duration_seconds和mercure_hub_subscriber_count - 当
publish_durationP95 > 100ms 且subscriber_count突降，大概率是 Hub 连接池耗尽或 JWT 验证卡住 - 检查
curl -s http://localhost/metrics | grep mercure_hub输出，确认指标是否正常上报；若为空，说明 metrics 路由未生效或权限被拦截
最容易被忽略的三个延迟放大点
很多团队只盯着 PHP 到 Hub 的那一次 HTTP 请求，却漏掉真正吃掉几十甚至几百毫秒的环节：
-
topic字符串含非法字符（如空格、中文、未 URL 编码斜杠），Mercure Hub 会静默丢弃消息，既不报错也不记录 —— 必须用rawurlencode()处理 topic - 前端 EventSource 订阅 URL 里带多个
topic参数（如?topic=a&topic=b），Caddy Mercure 默认只认第一个，其余被忽略 - 开发环境用
http://localhost但没加insecure指令，导致 TLS 验证失败后重试 3 次，每次 100ms+，叠加成明显卡顿
