zip扩展安装失败八成因libzip缺失或版本过旧：宝塔面板点击安装报“configure: error: zip support requires libzip”或“cannot find libzip”，说明系统未安装libzip库或已装版本不兼容，需手动编译安装libzip并建立zipconf.h软链接后重试。
为什么zip扩展安装失败，八成卡在libzip上
宝塔面板点“安装zip扩展”失败，报错里出现 configure: error: zip support requires libzip 或 cannot find libzip，基本可以断定是系统缺少可用的 libzip 库，或者已有版本太旧（libzip.pc 和 zip.h。宝塔自带的系统源（如 CentOS 7 默认的 libzip 0.11）完全不够用。
手动编译libzip前必须确认的三件事
别急着 wget 编译，先检查这三项，否则白忙一场：
- 运行
pkg-config --modversion libzip，如果提示Package libzip was not found或版本低于1.6.0，才需要重装 - 确认系统已装
cmake和zlib-devel（libzip 编译依赖）：cmake --version、rpm -q zlib-devel（CentOS/RHEL）或dpkg -l zlib1g-dev（Ubuntu/Debian） - 检查
/usr/local/lib/pkgconfig/是否存在；若不存在，后续make install后需手动创建并写入路径，否则 PHP configure 找不到 libzip
编译安装libzip 1.9.2（适配PHP 8.1+）的实操步骤
以 CentOS 7/8 或 Rocky Linux 9 为例，直接执行以下命令（注意路径和权限）：
cd /tmp 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/local -DZLIB_INCLUDE_DIR=/usr/include -DZLIB_LIBRARY=/usr/lib64/libz.so .. make -j$(nproc) sudo make install
关键点：
-
cmake而非./configure：新版 libzip 已弃用 autotools，强行用 configure 会失败 -
-DCMAKE_INSTALL_PREFIX=/usr/local：确保库文件落到系统标准路径，避免后续 PHP 编译时找不到 - 编译完必须执行
sudo ldconfig，否则phpize阶段仍会提示 “library not found” - 验证是否成功：
pkg-config --modversion libzip应输出1.9.2；ls /usr/local/lib/pkgconfig/libzip.pc必须存在
装完libzip后，zip扩展还是不生效？检查这两个硬性条件
libzip 装对了，不等于 zip 扩展就能跑。以下任一不满足，php -m | grep zip 依然为空：
-
extension=zip必须写在正确的php.ini里——不是宝塔面板“配置修改”页里那个只读预览文件，而是实际生效的路径，可通过php --ini查看 Loaded Configuration File - 扩展
.so文件必须在extension_dir指向的目录下，例如/www/server/php/81/lib/php/extensions/no-debug-non-zts-20210902/zip.so；如果用宝塔图形界面安装失败，手动编译 zip 扩展后，要确认make install输出的路径是否与该目录一致 - 重启 PHP 服务不能只点“重载配置”，得点“重启”——因为 zip 扩展涉及模块初始化逻辑，仅重载无法加载新扩展
最容易被忽略的是：libzip 编译时没带 -DBUILD_SHARED_LIBS=ON（默认开启），但某些旧系统 cmake 版本可能默认关掉它，导致生成静态库，PHP 动态加载失败。验证方式：file /usr/local/lib/libzip.so 输出中必须含 shared object 字样。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
