PHP 8.1 下 ZipArchive 缺失主因是 libzip 版本低于1.7.0或扩展未正确编译；需升级 libzip 至 ≥1.7.0（如1.9.2）、安装 php8.1-dev 和 libzip-dev、用 pecl 重装 zip 扩展，并通过 class_exists、常量访问及实际 open() 调用三重验证功能可用性。
PHP 8.1 环境下 ZipArchive 缺失，不是“没装”，而是 libzip 库版本不匹配或扩展未正确编译 —— 直接装 php-zip 包大概率无效，必须确认 libzip 开发头文件、PHP 配置路径、扩展编译目标一致。
为什么 apt install php8.1-zip 在某些服务器上不管用
Ubuntu/Debian 的 php8.1-zip 包依赖系统级 libzip-dev，但默认源里的 libzip 版本常为 1.5.x 或更低；而 PHP 8.1+ 要求 libzip ≥ 1.7.0 才能启用完整功能（比如 ZIP archive streaming、CRC32 checksum 校验）。若系统 libzip 太旧，即使扩展.so加载成功，new ZipArchive() 仍会报错或静默失败。
- 验证方式：
php -r "echo ZIPARCHIVE::CHECKSUM_CRC32;"—— 报错即说明底层 libzip 不支持 - 查当前 libzip 版本：
pkg-config --modversion libzip，低于 1.7.0 就得升级 - 别信
php -m | grep zip输出了就完事：模块名存在 ≠ 功能可用
手动编译 zip 扩展前必须确认的三件事
跳过这三步直接 pecl install zip，90% 概率编译出错或运行时崩溃。
-
php-config路径是否指向 PHP 8.1？运行which php-config和php-config --version双重核对 -
libzip-dev是否已安装？apt list --installed | grep libzip-dev，没装就先sudo apt install libzip-dev - PHP 源码或 dev 包是否就位？Ubuntu 下需
sudo apt install php8.1-dev，否则phpize会找不到头文件
实际可跑通的编译流程（Ubuntu/Debian）
以下命令按顺序执行，中间任何一步失败都别往下走：
立即学习“PHP免费学习笔记（深入）”；
- 升级 libzip 到 1.9.2（兼容 PHP 8.1）：
wget https://libzip.org/download/libzip-1.9.2.tar.gz && tar -xzf libzip-1.9.2.tar.gz && cd libzip-1.9.2 && mkdir build && cd build && cmake .. -DCMAKE_INSTALL_PREFIX=/usr && make && sudo make install - 清理旧扩展并重装：
sudo pecl uninstall zip && sudo pecl install zip - 确认
extension=zip.so已写入 CLI 对应的 php.ini（用php --ini查路径），且extension_dir指向正确的 so 存放目录（通常在/usr/lib/php/20210902/这类带 ABI 号的路径下） - 重启 PHP-FPM：
sudo systemctl restart php8.1-fpm（CLI 不需要重启，但要清 opcache：php -r "opcache_reset();"）
验证是否真正可用，而不是“看起来加载了”
光看 php -m 或 phpinfo() 里的 zip 模块是假安全。必须跑这三行：
-
php -r "var_dump(class_exists('ZipArchive'));"→ 必须输出bool(true) -
php -r "echo ZIPARCHIVE::CREATE;"→ 不报错即基础常量可用 -
php -r "$z = new ZipArchive(); echo $z->open('test.zip', ZIPARCHIVE::CREATE) === TRUE ? 'OK' : 'FAIL'; unlink('test.zip');"→ 实际调用创建能力
最后这条失败，八成是 libzip 版本或权限问题。Docker Alpine 用户注意：apk add php81-zip 必须和 php -v 版本严格一致，错一个 patch 号（如 8.1.23 vs 8.1.24）就会导致 undefined symbol: zip_libzip_version 这类符号缺失错误。
