FrankenPHP 实现 AI 流式响应逐字显示需后端禁用所有缓冲（ini_set、ob_end_flush、X-Accel-Buffering: no）、每字符调用 echo + flush + fflush，前端用 fetch + ReadableStream 逐块解码渲染。
FrankenPHP 中如何实现 AI 流式响应逐字显示
不能直接靠 FrankenPHP 自身实现逐字（character-by-character）渲染，它只负责 PHP 与 Go 的桥接，流式输出依赖的是 PHP 层的输出控制 + 前端 SSE 或 fetch + ReadableStream 处理。核心是：后端按字符或小 chunk 输出、禁用缓冲、设置正确 header；前端用流式 API 拆解并逐帧渲染。
PHP 后端必须关闭所有输出缓冲
FrankenPHP 默认启用 output_buffering，且 Go 层还可能缓存 HTTP body，导致即使 PHP echo 单个字符，前端也收不到直到缓冲满或脚本结束。必须显式关闭：
- 在脚本开头加
ini_set('output_buffering', 'Off');、ini_set('zlib.output_compression', 'Off'); - 调用
ob_end_flush()和ob_implicit_flush(true)确保无隐式缓冲 - 关键：发送
header('X-Accel-Buffering: no')（Nginx 兼容头），FrankenPHP 会识别并禁用内部缓冲 - 务必设置
header('Content-Type: text/event-stream; charset=utf-8')或text/plain，并保持连接不关闭
用 flush() + fflush() 强制逐字符推送
仅 echo 不够，PHP 的 stdout（对应 CGI 标准输出）仍可能被 libc 缓冲。需配合底层刷新：
- 每输出一个字符（或极短字符串，如 1–4 字符），立即调用
echo $char; flush(); fflush(STDOUT); - 避免使用
print_r、var_dump等调试函数——它们会破坏流格式，且自带换行和 HTML 实体 - 若 AI 使用
stream_get_contents()或fgets()读取模型响应，确保其 source 是非缓冲流（如 cURL 的CURLOPT_WRITEFUNCTION回调中逐块处理） - 测试时用
curl -N http://localhost:8080/chat（-N禁用 curl 缓冲），观察是否实时吐出字符
前端用 ReadableStream 拆解字节流而非等完整响应
SSE（EventSource）天然适合逐块，但「逐字」需要更细粒度控制，推荐 fetch + response.body.getReader()：
立即学习“PHP免费学习笔记（深入）”；
- 后端输出纯文本（非 SSE 格式）时，前端用
const reader = response.body.getReader() - 循环
reader.read()，每次拿到{ value: Uint8Array, done }，用new TextDecoder().decode(chunk)转字符串 - 对解码后的字符串按字符遍历：
for (const char of text) { el.textContent += char; }（注意中文等 Unicode 字符占多个字节，TextDecoder已处理） - 避免用
response.text()或response.json()——它们会等待整个 body 下载完成 - 若用 SSE，确保后端每字符后输出
data: \uXXXX\n\n并调用flush()，否则浏览器会合并事件
真正卡点往往不在 FrankenPHP，而在 PHP 的 stdout 缓冲链（libc → PHP output layer → FrankenPHP Go writer → HTTP transport）。逐字显示本质是把整条链路拉到最激进的非缓冲模式，任何一环松动都会导致“看起来没流式”。调试时优先确认 curl -N 是否实时返回字符，再查前端流消费逻辑。
