ZipArchive 错误主因是 PHP 缺少或未启用 zip 扩展、libzip 版本不兼容；需检查扩展是否加载（php -m | grep zip 或 class_exists），依系统安装对应扩展，并确保 libzip≥1.6.0，Docker 或紧急时可禁用 ZipArchive 回退 unzip。
ZipArchive 错误通常不是 Composer 本身的问题，而是 PHP 环境缺少 ZIP 扩展、扩展未启用、或系统级依赖（如 libzip）不兼容导致的。修复重点在确认扩展状态和底层支持。
检查 ZipArchive 扩展是否已加载
运行 php -m | grep zip，看输出中是否有 zip；若无，说明扩展未启用或未安装。也可创建一个 PHP 文件写 var_dump(class_exists(‘ZipArchive’));，返回 false 即未就绪。
- Linux（Debian/Ubuntu）：执行 sudo apt install php-zip，再重启 Web 服务（如 sudo systemctl restart apache2 或 php-fpm）
- Linux（CentOS/RHEL）：用 sudo yum install php-pecl-zip 或 sudo dnf install php-zip
- macOS（Homebrew + PHP）：运行 brew install php@8.2-zip（版本号按实际调整），并确认 extension=zip.so 在 php.ini 中未被注释
- Windows：打开 php.ini，取消 ;extension=php_zip.dll 前的分号，确保 php_zip.dll 存在于 ext 目录且 PHP 版本匹配
验证 libzip 版本兼容性
PHP 的 ZipArchive 依赖系统级 libzip 库。较新 PHP（如 8.0+）要求 libzip ≥ 1.6.0；若系统自带版本太旧（如 CentOS 7 默认 libzip 0.10），即使 PHP 扩展启用，解压大包或含特殊字符路径的 ZIP 时仍可能报错（如“unable to decompress gzipped file”或“invalid archive”）。
- 查版本：pkg-config –modversion libzip（Linux/macOS）
- 旧系统建议源码编译升级 libzip：下载 libzip 官方新版 ，configure 时加 –enable-gcrypt=no 避免额外依赖，安装后重新编译 PHP 或重装 zip 扩展
- Docker 用户可在 Dockerfile 中显式安装新版 libzip，再装 PHP 扩展
临时绕过 ZipArchive（仅调试用）
若紧急需继续安装，可让 Composer 回退到用系统 unzip 命令解压（需本地有 unzip 工具 ）：
- 设置环境变量：export COMPOSER_DISABLE_ZIP_ARCHIVE=1
- 或运行：php composer.phar install –no-plugins（部分插件会强制用 ZipArchive）
- 注意：这不能解决根本问题，且某些私有仓库或自定义 installer 可能不兼容该模式
基本上就这些。核心是确认 zip 扩展可用 + libzip 不拖后腿。不复杂但容易忽略底层库版本匹配。
