Composer镜像体积无损压缩实践-composer-PHP中文网

不能对镜像元数据直接启用nginx gzip，因composer v2协议依赖http range请求按字节偏移随机访问json字段，而流式gzip破坏可寻址性；且客户端默认不发accept-encoding: gzip，服务端擅自返回gzip会导致go解析器panic，属协议级不兼容。

composer镜像体积无损压缩实践

Composer 镜像元数据（如 packages.json、provider-laravel~framework.json）不能靠 HTTP 层 gzip 流式压缩来“无损减体积”，强行启用会破坏随机访问能力，触发客户端 panic；所谓“无损压缩”，实际只发生在本地已下载的元数据快照上，且必须绕过镜像协议本身。

为什么不能对镜像元数据直接启用 nginx gzip

Composer v2 协议依赖 HTTP Range 请求跳转到 JSON 特定字段（比如 dist.shasum 或 versions 数组起始位置），而流式 gzip 会破坏字节偏移可寻址性。更关键的是：composer install --prefer-dist 客户端（v2.9.6+）默认不发送 Accept-Encoding: gzip，服务端若擅自返回 Content-Encoding: gzip，会导致 Go JSON 解析器报 json: cannot unmarshal object into Go struct field —— 这不是配置错误，是协议级不兼容。

官方镜像（阿里云、清华源等）从不 gzip 元数据文件，只对 ZIP 包启用压缩
用 curl -I https://mirrors.tuna.tsinghua.edu.cn/composer/packages.json 可验证：响应头含 Content-Type: application/json，但无 Content-Encoding
nginx 配置里写 gzip on + gzip_types application/json 是典型误配，只会让部分请求失败或卡住

metadata-minifier 是怎么做到“无损”的

composer/metadata-minifier 不动镜像服务端的任何文件，它只处理本地已下载的元数据副本（例如 vendor/composer/installed.json），属于运行时后处理，和镜像协议完全解耦。

Discussion Composer

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

下载

它把长字符串键名映射为数字索引：如 "name" → 0、"version" → 1、"require" → 2
移除注释、合并重复字段、扁平化嵌套结构，再用标准 json_encode() 序列化
输出仍是合法 JSON，json.Unmarshal 可直接解析，字段语义不变，不影响 composer install 行为
体积通常减少 30%~50%，但必须完整加载原始 JSON 到内存——不适合高并发在线校验场景

真正影响线上性能的是首字节延迟，不是压缩比

镜像选择不该看官网写的“Brotli 压缩率 42%”，而应实测 curl -w "%{time_starttransfer}" -o /dev/null https://.../packages.json 的中位数。HTTP/2 支持、CDN 节点位置、TLS 握手速度，权重远高于压缩算法本身。

华为云镜像用 Brotli 省 15% 体积，但在华东用户侧 time_starttransfer 中位数 1.38s；清华源用 gzip，中位数仅 0.41s
某些镜像为省带宽强制 gzip，但 Nginx 配置错导致 Content-Length 错乱，cURL 会反复重试直到 read timeout
provider 文件的字段结构比数量更重要：清华源将 require 从嵌套对象简化为字符串（如 "php": "^8.1"），解析快约 18%；阿里云保留完整依赖树，同等大小下更慢