多进程下PHP实时输出会乱序或丢失，因子进程共享stdout文件描述符导致并发写入竞争；应避免直接写stdout，改用独立日志文件或proc_open非阻塞读取并由主进程统一输出。
PHP 实时输出在多进程下会乱序或丢失吗
不安全，echo / print 这类标准输出在多进程（如 pcntl_fork）中默认不加锁，多个子进程同时写 stdout 会导致内容交错、截断甚至缓冲区错位。这不是 PHP 特有，而是底层 OS 对同一文件描述符（fd 1）的并发写入竞争问题。
常见现象：php: stdout: Broken pipe 错误、输出字符粘连（如“HellogWorld”）、某进程输出完全消失。
- 父子进程共享 stdout 文件描述符，但各自缓冲区独立，
flush()无法跨进程同步 - CLI 模式下 stdout 默认行缓冲，但 fork 后缓冲状态不可控
- Web SAPI（如 FPM）根本不允许
pcntl_fork，强行调用会崩溃或静默失败
如何让多进程 PHP 安全地实时输出到终端
核心思路：避免多个进程直接写同一 stdout；改用进程隔离的输出通道，再由主进程统一收集、排序、打印。
- 子进程用
error_log($msg, 4)写到内存（返回字符串），或写入唯一命名的临时文件（如/tmp/output_$$） - 主进程用
pcntl_waitpid()回收子进程后，读取对应输出并按$$（PID）或启动顺序拼接 - 若需真正“实时”，可用
proc_open()+stream_set_blocking($pipes[1], false)非阻塞读子进程 stdout，配合pcntl_signal(SIGCHLD, ...)异步处理
示例片段（简化版）：
立即学习“PHP免费学习笔记（深入）”；
$proc = proc_open('php child.php', [
1 => ['pipe', 'w'],
2 => ['pipe', 'w']
], $pipes);
stream_set_blocking($pipes[1], false);
while ($proc && proc_get_status($proc)['running']) {
$line = fgets($pipes[1]);
if ($line !== false) echo "[child] $line";
usleep(10000);
}
为什么不要用 ob_flush() + flush() 解决多进程输出
这两个函数只作用于当前进程的输出缓冲层，对操作系统级的 stdout fd 竞争毫无影响。它们甚至可能因 SAPI 差异失效：CLI 下 ob_flush() 基本无效，flush() 在非 CGI 模式下常被忽略。
-
ob_start()开启的缓冲是进程私有的，fork 后子进程继承的是空缓冲或已刷出状态，不可靠 - 调用
fflush(STDOUT)仅强制刷新 C 标准库缓冲区，不能解决多个进程对同一 fd 的 write() 系统调用冲突 - 某些终端（如 tmux、IDE 内置终端）还会二次缓冲，加剧乱序
更稳妥的替代方案：用日志文件 + tail -f 模拟实时
放弃“直接输出到当前终端”的执念，改用追加写日志文件，再另起终端 tail -f 查看——这是生产环境最稳定的做法。
- 每个子进程写独立日志：
file_put_contents("log_$$", "start\n", FILE_APPEND | LOCK_EX) - 主进程写汇总日志，用
date('H:i:s') . " [$$] msg\n"带时间戳和 PID，便于事后排查 - 注意
LOCK_EX只能防止同进程多次写冲突，不同进程仍需用flock()手动加锁（file_put_contents的LOCK_EX参数已涵盖）
真正难的不是“怎么输出”，而是“怎么让输出可追溯、可归因、不丢失”。多进程下，把 stdout 当作只读终端、把日志当通信媒介，反而更健壮。
