PHP应使用proc_open()配合非阻塞读取实时捕获Python进度，Python端需print(…, flush=True)，输出PROGRESS:JSON格式，PHP轮询fgets()并设超时，Web环境推荐Redis/文件存进度供前端AJAX轮询。
PHP调用Python脚本并实时捕获stdout进度
PHP本身无法直接“监听”Python进程的内部状态，但可以通过标准输出流（stdout）逐行读取Python脚本打印的进度信息。关键在于Python端主动flush、PHP端用非阻塞或逐行读取方式避免卡死。
- Python脚本必须在print后加
sys.stdout.flush()（或用print(..., flush=True)），否则缓冲区不立即输出，PHP会一直等 - PHP不能用
exec()或shell_exec()—— 它们只返回最终输出，拿不到中间过程 - 推荐用
proc_open()配合stream_set_blocking($stdout, false)实现非阻塞轮询，每100ms检查一次新行 - 避免用
while (!feof($stdout))直接读——若Python还没写完，feof会阻塞，导致PHP挂住
Python端进度输出格式建议（兼容PHP解析）
不要依赖复杂结构，用简单可预测的文本协议最稳。比如固定前缀 + JSON片段，或纯key=value行。
- 推荐格式：
PROGRESS:{"percent":35,"msg":"正在处理第124条"} - 避免空行、ANSI控制符、多行JSON——PHP逐行读时会错位
- 如果Python用 tqdm，务必关掉它默认的回车覆盖（
tqdm(..., leave=True, file=sys.stdout)不够，要设dynamic_ncols=False, bar_format="{l_bar}{bar}| {n_fmt}/{total_fmt} [{elapsed}s]"并手动print+flush） - 错误信息建议走stderr，PHP可单独捕获，避免和进度混在一起
PHP端轮询读取与超时控制
proc_open打开后，stdout是资源句柄，需配合 stream_select() 或定时轮询，否则容易假死或漏数据。
