zip 扩展未加载导致 composer 安装失败，需用 php -r "echo class_exists('ziparchive') ? 'ok' : 'missing';" 确认；再通过 composer diagnose 和 php --ini 定位 php cli 配置路径；依系统安装对应 zip 扩展并验证 new ziparchive() 可实例化。
直接装不上，因为 Composer 默认用 PHP 的 ZipArchive 类解压 dist 包，而这个类根本没加载——不是 Composer 坏了，是 PHP 缺模块，且 CLI 环境没认上。
怎么确认 zip 扩展真没加载（别猜）
运行这行命令最可靠：
php -r "echo class_exists('ZipArchive') ? 'OK' : 'Missing';"
返回 Missing 就坐实问题。比 php -m | grep zip 更准，避免大小写或模块名拼错导致漏判。
再补查两件事：
-
composer diagnose看 “PHP binary” 路径，确保你后续操作的是同一个 PHP -
php --ini确认 CLI 加载的php.ini路径，别在 Apache 的 php.ini 里改半天，CLI 根本不读它
Linux 各发行版安装 zip 扩展的实操要点
包名、命令、路径全都不一样，抄错就白忙：
- Ubuntu/Debian：先看 PHP 版本（
php -v），再装对应包，比如 PHP 8.2 就用sudo apt install php8.2-zip；装完不用改php.ini，它会自动生成/etc/php/8.2/cli/conf.d/20-zip.ini - CentOS/RHEL 8+：
sudo dnf install php-zip；RHEL 7 则是sudo yum install php-pecl-zip，装完手动检查/etc/php.d/zip.ini是否存在且内容为extension=zip - Alpine（Docker 常见）：
apk add php8-zip（按实际版本选php7-zip或php8-zip），装完必须新开 shell，否则php -m还是旧环境
Windows 和 macOS 下最容易踩的坑
Windows 用户常卡在 DLL 名和路径上：
- PHP 8.0+ 不再用
php_zip.dll，而是zip.dll；php.ini里写extension=zip即可，别写extension=php_zip.dll - 确认
extension_dir指向正确目录（如C:\php\ext），且该目录下真有zip.dll - macOS Homebrew 用户：装完
brew install php@8.2后，检查$(brew --prefix)/etc/php/8.2/php.ini里是否有extension=zip；若没有，手动加一行，不要依赖“自动启用”
验证是否真正可用（绕过报错不等于修好了）
装完、改完、重启完，最后一步必须跑：
php -r "new ZipArchive(); echo 'ok';"
不报错才说明 ZipArchive 类能实例化。如果报 Class 'ZipArchive' not found 或 Call to undefined function zip_open()，说明扩展虽加载但没导出类——大概率是 extension=zip 行被注释了，或者 php.ini 被别的 conf.d 文件覆盖了。
最常被忽略的是：CI 环境（如 GitHub Actions 的 ubuntu-latest）默认 PHP 不带 zip，必须显式 apt install php-zip，否则 composer install 在 pipeline 里静默失败，连错误日志都不完整。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
