ziparchive类不可用需实测php -r "new ziparchive();"不报错，仅php -m | grep zip输出不等于可用；必须确认cli php版本对应扩展已装、php.ini正确启用extension=zip、libzip依赖兼容且路径无误。
不是“找不到Zip程序”，而是 PHP 的 ZipArchive 类不可用——Composer 依赖的是 PHP 内置 zip 扩展，不是系统命令行的 unzip 或 zip 工具。误判这点会导致白忙活半天。
php -m 显示 zip ≠ ZipArchive 可用
很多用户看到 php -m | grep zip 有输出就以为万事大吉，结果 composer install 还是报 Class 'ZipArchive' not found。这是因为模块名加载成功 ≠ 类能实例化。
- 必须运行
php -r "new ZipArchive();"—— 不报错才算真正可用 - 常见失败原因：
php.ini里写的是extension=php_zip.dll（旧写法），但 PHP 8.0+ 要求写extension=zip - Linux 下装了
php-zip包，但 CLI 模式实际加载的是另一个 PHP 版本（比如系统自带 PHP 7.4，而你装的是 php8.2-zip） - macOS Homebrew 安装后，
ext-zip.ini被放在/opt/homebrew/etc/php/8.2/conf.d/，但php --ini显示的配置路径没包含它
Ubuntu/Debian 下装错包名直接失效
硬写 sudo apt install php-zip 在多版本共存环境下大概率失败。Ubuntu 默认不提供无版本号的 php-zip 元包，它只是个虚拟包，实际得按当前 CLI 使用的 PHP 版本精准安装。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 先确认版本：
php -v输出PHP 8.2.12→ 就得装php8.2-zip - 装完检查：
php -i | grep "zip support"必须返回zip support => enabled，不能只看php -m - 如果用了
php-fpm，重启对应服务：sudo systemctl restart php8.2-fpm；CLI 模式不用重启，但要新开终端生效 - CI 环境（如 GitHub Actions）默认不带 zip，必须显式加一步：
sudo apt-get install -y php8.2-zip
Docker Alpine 镜像默认不带 zip 扩展
php:8.2-cli-alpine 这类精简镜像连 libzip 库都不含，光装扩展会编译失败。顺序错了就白跑。
- 正确顺序：
RUN apk add libzip-dev && docker-php-ext-install zip && docker-php-ext-enable zip - 别漏
libzip-dev—— 否则docker-php-ext-install zip会提示configure: error: system libzip must be upgraded to version >= 1.6.0 - 验证用：
RUN php -r "new ZipArchive();"放在 Dockerfile 最后一行，构建失败即止 - Alpine 上的
php8-zip包（来自 community 源）不可靠，容易和 PHP 主版本不匹配，优先走源码编译
Windows 下 dll 文件根本不存在
取消 php.ini 中 ;extension=zip 注释只是第一步。XAMPP/WAMP/手动解压版 PHP 常见问题是：指定路径下压根没有 php_zip.dll 或 zip.dll。
- 查
extension_dir路径：php --ini→ 看 “Scan for additional .ini files in” → 进该目录下的ext/子目录 - 运行命令定位：
dir "%PHP_HOME%\ext\php_zip.dll" 2>nul || dir "%PHP_HOME%\ext\zip.dll" 2>nul - PHP 8.0+ 官方 Windows 包已移除
php_zip.dll，改用zip.dll，且要求 TS（线程安全）版 + VC17 运行库匹配 - 若文件缺失，重下对应版本完整包（不是 NTS 版），或从旧版 PHP 复制
php_zip.dll（风险高，不推荐）
最常被忽略的点：同一台机器上 CLI 和 Apache/Nginx 的 PHP 配置完全独立，php --ini 查到的路径才是 Composer 生效的唯一依据。别在网页 phpinfo() 里确认完就收工。
