PHP在Docker中echo/print不实时显示是因stdout全缓冲所致：非TTY环境下CLI默认全缓冲，需同时调用ob_implicit_flush(true)、stream_set_write_buffer(STDOUT, 0)并加-t参数。
400-7654-355 echo / print 在 Docker 容器里不实时显示？是缓冲惹的祸默认情况下，PHP 的标准输出（echo、print）在 Docker 容器中通常不会立即刷出，尤其用 php -S 或 Nginx + PHP-FPM 时更明显。这不是 Docker 的 bug，而是 PHP 自身的输出缓冲机制 + CLI/SAPI 环境差异共同导致的。
关键点：CLI 模式下，PHP 默认启用 stdout 行缓冲（line-buffered），但仅当 stdout 是终端（tty）时才生效；Docker 容器启动时若没加 -t，stdout 就是管道，变*缓冲（fully buffered），导致内容卡住几秒甚至到脚本结束才吐出来。
var_dump(php_sapi_name()); 和 var_dump(ob_get_level());，确认是 cli 且无手动开启的输出缓冲docker run -t（分配伪 TTY），看是否立刻输出——如果好了，基本锁定是缓冲模式切换问题flush() 单独调用，它只刷 PHP 用户层缓冲，不保证 OS 层或 Web 服务器层也同步要在容器里稳定做到“每行即见”，需同时处理 PHP 层、OS 层和运行时环境：
ob_implicit_flush(true) 关闭用户输出缓冲（比 ob_end_flush() 更可靠，避免因嵌套缓冲出错）stream_set_write_buffer(STDOUT, 0) 关掉 C 标准库对 stdout 的缓冲（这是解决非 TTY 下全缓冲的关键）-t（如 docker run -t php:8.2-cli php script.php），否则 stream_set_writ
e_buffer 在某些 PHP 版本下可能失效示例最小可行脚本：
Web 场景（Nginx + PHP-FPM）下实时输出更难，别硬刚
PHP-FPM 默认禁用
fastcgi_finish_request()之外的实时输出，Nginx 还会自己缓存响应体（proxy_buffering on）。想在浏览器看到逐行更新，得全链路打通：
ob_flush() + flush()（注意顺序：先 ob_flush() 再 flush()）proxy_buffering off;、fastcgi_buffering off;（后者需 NGINX 1.19.6+）Content-Type: text/plain 或 text/event-stream，浏览器对 text/html 有额外解析延迟php_flag[output_buffering] = Off，并确认 php_admin_value[output_handler] = ""
即便如此，移动端 Safari、某些 CDN 仍可能截断流式响应——实时日志类需求，建议改用 WebSocket 或 SSE，别死磕 flush()。
PHP 8.0+ 对 CLI 的 stdout 缓冲策略做了调整，stream_set_write_buffer(STDOUT, 0) 在非 TTY 下更稳定；但 PHP 7.4 及更早版本在 Alpine 镜像里常因 musl libc 表现异常，表现为 flush() 无效或报 failed to flush 错误。
apk add --no-cache php82-posix（补全 POSIX 扩展），部分缓冲控制函数依赖它php:alpine 直接跑调试脚本，改用 php:apache 或 php:cli（Debian base）更可控exec 启动 PHP 而非直接 ENTRYPOINT ["php"]，父进程（如 shell）可能引入额外缓冲，建议用 exec php script.php
真正卡住的时候，往往不是代码写错了，而是你没意识到 Docker 的 I/O 模式、PHP 的 SAPI 类型、libc 实现这三层缓冲正在叠 Buff。
