如何手动编译libzip依赖库解决宝塔面板PHP安装zip扩展失败问题？

本文共计783个文字，预计阅读时间需要4分钟。

请提供您想要改写的伪原创开头内容，我将根据您的要求进行改写。

手动编译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

关键点：

立即学习“PHP免费学习笔记（深入）”；

• 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 字样。