Composer CLI默认不发Accept-Encoding: gzip头，故镜像站不压缩响应；需用curl -H "Accept-Encoding: gzip"直连验证，且须确保PHP启用zlib、关闭output_compression、memory_limit充足。
Composer 中文镜像站（如阿里云、腾讯云、华为云等）的 /p/ 和 /packages.json 接口在 v2 协议下默认启用 gzip 压缩，但实际效果取决于客户端请求头与服务端配置协同——不是“开了就一定压缩”，而是“满足条件才压缩”。
你遇到的响应体积没变小、curl -H "Accept-Encoding: gzip" 仍返回未压缩 JSON，大概率不是镜像站没开压缩，而是你的请求或环境触发了绕过逻辑。
为什么 Composer CLI 请求不走 gzip？
Composer 自身发起的 HTTP 请求（比如 composer update）默认不带 Accept-Encoding: gzip 头——它依赖底层 ext-curl 或 stream 的自动解压能力，而服务端会根据是否收到该 header 决定是否压缩。但官方实现中，Composer\Util\HttpDownloader 在构造 request 时并未显式设置该 header。
- 验证方式：运行
composer update --dry-run -vvv，搜索日志中的GET https://mirrors.aliyun.com/composer/p/vendor/package.json，看响应头是否含Content-Encoding: gzip - 若无，说明镜像站未对 Composer 默认 UA 响应压缩（部分镜像为兼容旧版 Composer v1，会跳过压缩）
- 这不是 bug，是历史兼容策略：v1 客户端未声明支持 gzip，服务端主动压缩反而可能引发解压失败
如何确认镜像站 API-V2 是否真启用 gzip？
绕过 Composer 自身逻辑，用标准 HTTP 工具直连测试：
- 执行：
curl -I -H "Accept-Encoding: gzip" https://mirrors.tencent.com/composer/packages.json - 检查响应头：
Content-Encoding: gzip和Content-Length（通常 - 对比无 header 请求：
curl -I https://mirrors.tencent.com/composer/packages.json，Content-Length应明显更大 - 注意：部分镜像（如华为云）对
User-Agent: Composer/*的请求强制关闭 gzip，需临时伪造 UA：curl -H "User-Agent: curl/8.0" -H "Accept-Encoding: gzip" ...
自建镜像或反向代理时的压缩陷阱
如果你用 Nginx / Caddy 反代官方镜像或搭建私有 Packagist，gzip 配置必须显式匹配 Composer-V2 的响应特征：
- 不能只靠
gzip on：V2 接口返回的是 JSON（application/json），而 Nginx 默认只压缩text/html等类型，需加gzip_types application/json; - 避免压缩已压缩内容：镜像源本身可能已返回 gzip，再套一层会导致客户端解压失败；建议用
gzip_proxied any;并配合gzip_disable "msie6"; - 关键阈值：
gzip_min_length 1024;—— V2 的packages.json通常 >1MB，没问题；但单个/p/xxx/xxx.json可能仅几 KB，低于阈值会被跳过
PHP 运行时解析压缩响应的隐性开销
即使服务端返回了 gzip，Composer 在 PHP 层解压时仍可能因扩展缺失或配置失效导致 fallback 到未压缩路径：
- 确认
zlib扩展已启用：php -m | grep zlib - 检查
zlib.output_compression = Off（必须关，否则与 stream wrapper 冲突） - 某些 Docker 环境（如 Alpine）默认无
zlib，apk add zlib-dev后需重新编译 PHP - 最隐蔽的问题：
memory_limit不足时，gzdecode()可能静默失败，Composer会退回到慢速纯文本解析——表现为update耗时陡增但无报错
真正起效的压缩优化，不在服务端开关一开就完事，而在于请求头、代理层、PHP 运行时三者对 gzip 流程的全程可控。漏掉任意一环，都可能让本该减半的传输量原样跑满带宽。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
