zlib_decode(): data error 根本原因是 php zlib 扩展不支持 zip64 或含数据描述符的 zip 包，而非镜像源问题；需清理对应包缓存、关闭 zlib.output_compression、或改用 7z/unzip 外部解压工具。
zlib_decode(): data error 这类报错和镜像源本身关系不大，真正卡住的是 PHP 自带的 zlib 扩展对 ZIP 流的解析能力——它不支持 ZIP64 或含数据描述符（data descriptor）的 ZIP 包，而很多 Composer 包（尤其是 Laravel、Symfony 生态的新版本）正用这种格式打包。
删缓存、换镜像、重试三连操作往往无效，因为问题不在网络或配置，而在 PHP 解压逻辑本身。
为什么 zlib_decode(): data error 总在下载后立刻触发
Composer 默认从缓存复用 ZIP 文件。一旦某个包的 ZIP 被截断、校验失败或本身就是 ZIP64 格式，后续所有安装都会反复喂给 zlib_decode() 一个它无法处理的流，直接崩。
- 运行
composer install -v可看到具体失败的包路径，比如laravel/framework/11.12.0.zip - 手动删掉对应缓存：
rm -rf ~/.composer/cache/files/laravel/framework/（Linux/macOS）或%APPDATA%\Composer\Cache\files\laravel\framework\（Windows） - 更省事的临时方案：
composer install --no-cache，强制跳过缓存走网络重下
zlib.output_compression 必须关掉
如果 PHP 配置里 zlib.output_compression = On，Composer 的 HTTP 响应流会被 PHP 二次压缩，传给 zlib_decode() 的是一段嵌套乱码，100% 报错。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 检查当前值：
php -i | grep "zlib.output_compression"，输出必须是Off（不是0或空） - 若为
On，在 php.ini 中显式设为zlib.output_compression = Off，然后重启 CLI 环境 - 某些 Docker 镜像或宝塔环境会默认开启，这点极易被忽略
绕过 PHP zlib，换用系统级解压工具
Composer 支持用外部命令替代内置解压，彻底避开 zlib_decode()。前提是系统装了 7z 或 unzip。
- Linux/macOS：确保
7z可执行，然后设环境变量：COMPOSER_UNZIP=7zip composer install - Windows：用
set COMPOSER_UNZIP=7zip（CMD）或$env:COMPOSER_UNZIP="7zip"（PowerShell） - 验证是否生效：加
-v参数运行，日志里出现Executing command (7zip):即成功
别让 --prefer-dist 和 symlink 问题混淆视线
zlib_decode(): data error 和 Failed to create symbolic link 是两类完全独立的问题。前者发生在 ZIP 解压阶段，后者在 vendor 构建阶段。即使你已启用 --prefer-dist，只要 ZIP 文件本身不兼容 zlib，照样报错。
- 别试图用
--prefer-dist修复zlib_decode错误——它解决不了解压问题 - 如果你同时遇到 symlink 和 zlib 错误，要分开处理：先用
--prefer-dist绕过 symlink，再按上面三步修 zlib - 某些 CI 环境（如 GitHub Actions）默认禁用 symlink 且没装 7z，
zlib_decode错误反而更容易暴露
-v 日志定位到具体包，再一层层排除——而不是一上来就清整个 cache 或重装 Composer。
