php 8.2 默认不编译 zip 扩展，宝塔“极速安装”完全跳过，“编译安装”也需手动添加 --enable-zip 和 --with-libzip=/path；系统 libzip 版本须 ≥ 1.9.0（centos/almalinux 默认过低），须源码编译安装并配置 ldconfig，重编译前必须清空 src 目录以防链接旧库。
PHP 8.2 默认不带 zip 扩展，不是隐藏，是压根没编译进去
宝塔面板安装 PHP 8.2 时，“极速安装”模式完全跳过 zip 扩展；即使选“编译安装”，也默认不启用 --enable-zip，且不自动拉取或校验 libzip 依赖。这不是配置遗漏，是构建脚本主动排除——所以 php -m | grep zip 必然为空，extension=zip 写进 php.ini 也会报 “unable to load dynamic library”。
libzip 版本卡死：PHP 8.2 要求 libzip ≥ 1.9.0，但 CentOS/AlmaLinux 默认源只有 1.7.3 或 1.8.0
CentOS 7/8、AlmaLinux 8、Rocky Linux 8 的系统仓库里 libzip 版本普遍低于 PHP 8.2 编译要求（需 ≥ 1.9.0，且明确排除 1.3.1 和 1.7.0）。直接 yum install libzip-devel 会装错版本，configure 阶段就失败，日志末尾常见：
configure: error: system libzip must be upgraded to version >= 1.9.0
实操建议：
- 先查当前系统 libzip 版本：
pkg-config --modversion libzip或rpm -q libzip-devel - 若 ≤ 1.8.0，必须手动编译安装新版 libzip：
wget https://libzip.org/download/libzip-1.10.1.tar.gztar -xzf libzip-1.10.1.tar.gz && cd libzip-1.10.1./configure --prefix=/usr/local/libzip --enable-sharedmake && make install - 安装后注册路径：
echo "/usr/local/libzip/lib64" > /etc/ld.so.conf.d/libzip.conf && ldconfig
重装 PHP 8.2 时必须显式加 --enable-zip 并指定 libzip 路径
宝塔后台点「编译安装」不会自动加 zip 支持，必须进「编译选项」文本框手动补全参数。否则即使 libzip 装对了，configure 仍走默认逻辑，跳过 zip 模块。
实操建议：
- 在宝塔 PHP 设置页 → 「编译安装」→ 展开「编译选项」
- 清空原有内容，粘贴完整参数（以 libzip 安装到
/usr/local/libzip为例）：--enable-zip --with-libzip=/usr/local/libzip - 务必删掉其他非必要扩展参数（如
--with-icu-dir），避免与新 libzip 冲突 - 确认「PHP 版本」选的是 82，点击「开始编译」
编译成功后，还得手动验证 zip 是否真进内核，别信面板显示
宝塔编译完可能显示“安装成功”，但 /www/server/php/82/bin/php -m 仍无 zip —— 常见于 configure 时 libzip 路径没生效，或编译过程静默跳过 zip 模块。
验证步骤：
- 检查编译日志末尾是否有：
checking for zip archive support... yes - 运行：
/www/server/php/82/bin/php -i | grep -A5 "zip"，应输出 zip 相关配置项和 libzip 版本 - 写个测试脚本：
php -r "new ZipArchive(); echo 'ok';"，不报错才算真正可用 - 如果失败，回退检查：
find /www/server/php/82/src -name "config.log" | xargs grep -l zip，看 configure 实际用了哪个 libzip
最易被忽略的一点：libzip 升级后，旧版 PHP 编译产物里的 libzip.so 可能被缓存，不清理 src 目录直接重编译，仍会链接旧库。务必在重装前删掉 /www/server/php/82/src 整个目录。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
