ZipArchive类未找到是因PHP未启用zip扩展，需根据系统手动安装并启用：Linux/macOS用包管理器安装后检查配置；Windows需在php.ini中取消extension=zip注释，并确认php.ini路径正确。
Composer 报错 ZipArchive class not found
这是 Composer 在安装或更新包时最典型的扩展缺失错误，本质是 PHP 运行时找不到 ZipArchive 类——它不是默认启用的扩展，必须手动开启。报错通常长这样：Class 'ZipArchive' not found 或 Failed to download ...: zip extension is required。
确认 PHP 是否启用了 zip 扩展
别猜，直接验证：
- 运行
php -m | grep zip（Linux/macOS）或php -m全量查看是否有zip - 运行
php -i | grep "zip"查看是否显示zip support => enabled - 如果用 Web 环境（如 Apache/Nginx），在
index.php里写，浏览器打开后搜索zip段落
注意：CLI（命令行）和 Web SAPI 的 PHP 配置文件可能不同，php -i 和 phpinfo() 显示的 Loaded Configuration File 路径要分别核对。
Linux/macOS 下启用 zip 扩展（常见发行版）
多数现代 PHP 包已内置 zip，但默认不加载：
立即学习“PHP免费学习笔记（深入）”；
- Debian/Ubuntu：
sudo apt install php-zip（PHP 8.0+ 对应php8.0-zip） - CentOS/RHEL 8+：
sudo dnf install php-zip - macOS + Homebrew：
brew install php@8.2（新版 brew 安装的 PHP 默认含 zip，老版本可补brew reinstall php@8.2 --with-zip，但该参数已弃用，建议重装） - 确认扩展已写入配置：检查
/etc/php/*/cli/conf.d/20-zip.ini或类似路径是否存在，内容应为extension=zip
改完重启 CLI 无需操作，但 Web 服务需重启：sudo systemctl restart apache2 或 sudo nginx -s reload。
Windows 下启用 php_zip.dll
PHP for Windows 是模块化分发的，zip 扩展需手动放开：
- 打开
php.ini（注意 CLI 和 Web 用的可能是两个文件），搜索;extension=zip - 去掉前面的分号，改为
extension=zip（PHP 8.0+ 推荐写法；旧版可能需写extension=php_zip.dll） - 确保
extension_dir指向正确的目录（如ext文件夹），且该目录下存在php_zip.dll - 保存后，命令行执行
php -v看是否报错；若无报错再试composer install
容易被忽略的是：Windows 下某些集成环境（如 XAMPP、WampServer）自带的 PHP 可能禁用 zip，且其 php.ini 位置藏得深（例如 Wamp 在 C:\wamp64\bin\php\php8.1.13\phpForApache.ini），务必确认改的是实际被加载的那个。
