ziparchive类不可用是php cli环境未真正加载zip扩展所致，必须运行php -r "new ziparchive(); echo 'ok';"验证，报错即缺失；还需检查php --ini确认cli配置路径、libzip版本及包名匹配（如ubuntu需php8.3-zip而非php-zip）。
ZipArchive 类不可用，不是 Composer 的问题，而是 PHP 当前 CLI 环境没真正加载 zip 扩展——装了包、写了 extension=zip、甚至 php -m | grep zip 有输出，都不等于能用。
怎么确认 ZipArchive 真可用？别信 php -m
运行这句才是硬标准：php -r "new ZipArchive(); echo 'OK';"。报 Fatal error: Uncaught Error: Class 'ZipArchive' not found 就坐实缺失。
更进一步验证底层支持：php -r "echo ZIPARCHIVE::CHECKSUM_CRC32;"，报错说明 libzip 太旧或没编译进扩展。
同时查 CLI 实际加载的配置：php --ini，避免 Web 和 CLI 的 php.ini 路径不一致。
Ubuntu/Debian 上装错包名就白忙活
硬写 sudo apt install php-zip 在 Ubuntu 22.04+ 及之后版本大概率失败，因为该包名已被弃用。
必须先查版本：php -v（比如输出 PHP 8.3.6），再装对应包：sudo apt install php8.3-zip。
装完检查：ls /etc/php/8.3/cli/conf.d/*zip*.ini 应存在 20-zip.ini，内容为 extension=zip。
若用 php-fpm，需重启服务：sudo systemctl restart php8.3-fpm；CLI 模式要新开终端，否则缓存旧配置。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
CentOS/RHEL/Rocky Linux 容易装错包
这些系统没有 php-zip 这个包，正确名称是 php-pecl-zip，且依赖 EPEL 源。
先启用 EPEL：sudo dnf install epel-release（RHEL 8+/Rocky 8+）或 sudo yum install epel-release（旧版）。
再安装：sudo dnf install php-pecl-zip。
装完检查 /etc/php.d/zip.ini 是否存在且内容为 extension=zip；若无，手动创建。
RHEL 7 用户注意：libzip 版本必须 ≥ 0.11，否则重装前得先升级 libzip-devel。
Docker Alpine 镜像里 zip 扩展常“假成功”
php:alpine 镜像默认不含 libzip 库，只装 php8-zip 会静默失败，日志只显示 Failed to extract，加 -v 才能看到 libzip version too old。
正确顺序：RUN apk add libzip-dev && docker-php-ext-install zip && docker-php-ext-enable zip。
漏掉 libzip-dev 会导致 configure: error: system libzip must be upgraded to version >= 1.6.0。
验证是否生效：在 Dockerfile 最后加 RUN php -r "new ZipArchive();"，构建失败即止。
Alpine 的 php8-zip 包（来自 community 源）可靠性差，优先走源码编译。
zip.so 文件，并绑定了兼容版本的 libzip”。路径、权限、ABI 兼容性、SAPI 差异，任何一个环节断了，ZipArchive 就只是个名字。
