基于Websocket实现的Composer镜像同步进度实时推送-composer-PHP中文网

composer install默认不显示进度条是因cli阻塞式输出且默认缓冲，需用-vvv定位卡点、--progress强制启用或--no-progress净化日志；真实进度需proc_open捕获stderr并解析json推送，非原生websocket支持。

基于websocket实现的composer镜像同步进度实时推送

PHP 项目中用 Composer 安装依赖时，进度条卡在 Downloading 却不显示具体进度，根本不知道是慢还是卡死——这不是 bug，是默认关闭了实时推送。要让镜像同步过程的下载进度真正“实时可见”，必须绕过 Composer 原生 CLI 的阻塞式输出，改用 WebSocket 主动推送给前端。

为什么 Composer install 默认不推送进度

Composer 的 install 和 update 命令本质是单次执行的 CLI 进程，所有输出（包括进度条）都写入 stdout/stderr 流，且默认使用缓冲模式。浏览器无法直接消费这种流式输出；即使你用 exec() 或 proc_open() 捕获，也得手动解析 ANSI 控制序列（如 \r、\033[2K），再转换成结构化进度数据——这一步极易出错，且不同 Composer 版本输出格式不一致。

Composer 2.5+ 的 --no-progress 实际上会禁用所有进度输出，不是“没显示”，而是压根没生成
COMPOSER_MEMORY_LIMIT=-1 等环境变量不影响输出行为，只影响内存限制
直接调用 composer install --quiet 会丢掉全部进度信息，不可逆

用 Ratchet + proc_open 实现带进度的 WebSocket 推送

核心思路：起一个独立的 PHP 后台进程，用 proc_open() 执行 composer install，逐行读取 stderr（进度信息主要在这里），解析出已下载字节数/总大小，再通过 Ratchet 的 ConnectionInterface 实时广播给连接的客户端。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

必须用 STDERR 而非 STDOUT：Composer 的进度条默认输出到 stderr，stdout 只有最终结果或错误
解析关键字段：每行匹配类似 - Installing vendor/package (1.2.3): Downloading (98%) 或 - Downloading https://mirrors.example.com/... (1.23 MiB/4.56 MiB)
避免阻塞：stream_set_blocking($pipes[2], false) 必须设为非阻塞，否则 fgets() 会卡住直到整行结束
注意信号处理：进程被 kill 时，需主动调用 proc_terminate() 并清理 ConnectionInterface 引用，否则连接泄漏

前端如何可靠接收并渲染进度

浏览器端不能依赖 onmessage 的顺序性——WebSocket 数据包可能乱序或粘包。服务端推送的数据必须带唯一标识和单调递增序号，前端按序号做防重、补漏。

服务端推送格式统一用 JSON：{"type":"progress","id":"install-abc123","seq":5,"package":"monolog/monolog","done":1245678,"total":3456789,"percent":36}
前端用 Map 缓存未按序到达的包，收到 seq:1 后才开始渲染，中间跳号则等待或超时丢弃
不要用 innerText 直接写入进度条文本：ANSI 转义字符（如 \033[2K）在 HTML 中无效，必须提前清洗或忽略
连接断开后，前端应自动重连并带上上次 id，服务端查缓存继续推送，而非重启整个 install

镜像源切换时的进度状态一致性

如果用户在安装中途切换 Composer 镜像（例如从 packagist.org 切到阿里云镜像），composer install 进程不会中断，但下载 URL 和总大小会变——此时已上报的 total 值失效，前端进度条可能倒退或卡住。

解决方案：服务端监听 onMessage 中的镜像切换指令，立即终止当前 proc_open 进程，清空所有缓存，返回 {"type":"reset","id":"install-abc123"}
前端收到 reset 后，清空进度条、重置计数器，等待新 seq:1 包
切镜像操作本身必须走独立 WebSocket 消息通道，不能混在进度流里，否则解析逻辑崩溃
注意 Composer 配置缓存：composer config --global repo.packagist composer https://mirrors.aliyun.com/composer/ 生效需 clear-cache，否则仍走旧源