核心原因是PHP CLI环境ZipArchive类不可用或系统临时目录空间不足；需实测php -r "new ZipArchive();"不报错，并检查/tmp或%TEMP%剩余空间，必要时切换TMPDIR或改用7z解压。
Composer 安装扩展时解压报错，核心原因只有两个：PHP CLI 环境里 ZipArchive 类根本不可用，或者系统临时目录（/tmp 或 %TEMP%）空间不足——不是 Composer 本身坏了，也不是包损坏了，而是解压这一步卡在底层依赖上。
确认 ZipArchive 是否真能用，别信 php -m
很多人跑完 php -m | grep zip 看到输出就以为搞定了，结果 composer install 还是崩。关键得实测类是否可实例化：
- 运行
php -r "new ZipArchive(); echo 'OK';"—— 不报错才叫真正启用 - 如果报
Fatal error: Class 'ZipArchive' not found，说明扩展没加载、DLL/SO 文件缺失、或php.ini路径改错了 - 用
php --ini查清楚 CLI 实际加载的是哪个php.ini，XAMPP/WAMP/手动安装常有多个配置文件，改错一个等于白干 - Windows 下注意：PHP 8.0+ 必须写
extension=zip（不带.dll），写extension=php_zip.dll会静默失败
Linux/macOS 下装 zip 扩展，包名不能抄错
不同发行版的包管理器对 zip 扩展的命名规则完全不同，装错名字就白忙：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- Ubuntu/Debian：
sudo apt install php-zip（自动启用，不用动php.ini） - CentOS/RHEL 8+：
sudo dnf install php-zip - CentOS/RHEL 7：
sudo yum install php-pecl-zip（不是php-zip，否则找不到包） - Alpine（Docker 常见）：
apk add php8-zip或apk add php7-zip，必须和你用的 PHP 版本严格匹配 - 装完必须新开终端再验证，否则环境没刷新，
php -m | grep zip可能还是空
解压失败但 zip 扩展已启用？先盯紧 TMPDIR
即使 ZipArchive 能 new 出来，composer install 还是报 failed to open stream 或 No space left on device，大概率是临时目录撑爆了：
- Composer 解压全程走系统临时目录：
/tmp（Linux/macOS）或%TEMP%（Windows），不是~/.composer/cache - 运行
echo $TMPDIR（Linux/macOS）或echo %TEMP%（Windows）确认当前路径 - 检查该目录剩余空间：
df -h /tmp或dir %TEMP%，很多服务器/tmp只有 1–2GB，而一个大包解压峰值要 1.5GB+ - 临时切大分区：
export TMPDIR="/mnt/bigdisk/tmp"，并确保目录存在且可写（chmod 777） - 验证生效：跑一次
composer install -v，看日志里解压路径是否已变
实在绕不过？用 7z 替代 PHP zip 扩展
当 zip 扩展启用困难（比如旧系统 libzip 版本太低、或 Docker 镜像限制多），直接换解压后端更省事：
- Windows：下载官方 7z.exe，放进 PATH，然后运行
COMPOSER_UNZIP=7zip composer install - Linux/macOS：装
7zz（brew install p7zip或apt install p7zip-full），确认which 7z有输出 - 这个方案不依赖
ZipArchive，也不要求libzip ≥ 1.6.0，但前提是命令行7z可调用 - 别用
COMPOSER_DISABLE_ZLIB=1，它强制纯 PHP 流式解压，慢到无法接受，且对 ZIP64 支持差，只应急
真正麻烦的从来不是“怎么装 zip”，而是你以为 zip 已启用、TMPDIR 有空间、缓存已清，结果 composer install 还在报错——这时候得一层层查 CLI PHP 加载了哪个 ini、哪个 so、依赖哪个 libzip 版本、临时目录到底写到哪去了，漏掉任意一环都白搭。
