5154

在 CentOS 7 系统中，libzip 是一个用于处理 ZIP 压缩档案的开源库，许多应用程序，尤其是使用 PHP 开发的 Web 应用（如需要处理文件上传和打包的功能），都可能依赖于 libzip 库，在 CentOS 7 上正确安装 libzip 是一项常见的系统管理任务，本文将详细介绍两种主要的安装方法，并提供验证、故障排除及常见问题解答,以确保您能够顺利完成安装并投入使用。

为什么需要安装 libzip？

libzip 提供了一组 C 语言 API，允许开发者读取、创建和修改 ZIP 文件，它比 PHP 内置的 Zlib 扩展功能更强大，支持更复杂的 ZIP 操作，例如添加、删除或替换压缩包内的文件，以及处理加密和注释等高级特性，当您运行的应用程序（通过 Composer 安装的某个 PHP 包）明确要求 libzip 的特定版本时,就必须在系统中进行安装。

安装方法一：使用 YUM 仓库安装（推荐新手）

这是最简单、最快捷的安装方式，CentOS 7 的默认软件仓库中包含了 libzip 的稳定版本,足以满足大多数基础应用的需求。

步骤 1：更新系统软件包

在安装任何新软件之前，建议先更新系统软件包列表和已安装的软件到最新版本,以确保兼容性和安全性。

sudo yum update -y

步骤 2：安装 libzip 及其开发包

libzip 库分为两个主要的软件包：

• libzip：运行时库,应用程序在运行时需要它。
• libzip-devel：开发包，包含了编译其他软件（如 PHP 扩展）时所需的头文件和静态库。

如果您只是运行一个已编译好的程序，通常只需要 libzip，但如果您后续需要编译依赖于 libzip 的软件（从源码编译 PHP），则必须安装 libzip-devel,建议将两者一并安装。

sudo yum install libzip libzip-devel -y

YUM 会自动处理所有依赖关系并完成安装。

步骤 3：验证安装

安装完成后,可以通过以下命令验证是否成功。

• 查看已安装的软件包信息：

  yum info installed libzip

  您将看到类似 Installed Packages 的输出,其中包含版本号和仓库来源。

• 查找库文件：

  

  find /usr/lib64 -name "libzip.so.*"

  正常情况下，您会看到类似 /usr/lib64/libzip.so.5 或 /usr/lib64/libzip.so.4 的输出,具体版本取决于仓库。

安装方法二：从源代码编译安装（推荐高级用户）

当 CentOS 7 默认仓库中的 libzip 版本过旧，无法满足应用程序对新功能或安全更新的要求时，从源代码编译安装是最佳选择，这种方法允许您安装任意最新版本的 libzip。

步骤 1：安装编译工具和依赖

编译 libzip 需要一些基础的开发工具和库，如 gcc、make、cmake 和 zlib-devel。

sudo yum groupinstall "Development Tools" -y
sudo yum install cmake zlib-devel -y

• Development Tools：一个软件包组，包含了 gcc, make 等核心编译工具。
• cmake：libzip 使用 CMake 作为其构建系统。
• zlib-devel：libzip 依赖于 zlib 库来处理压缩算法,此开发包是编译所必需的。

步骤 2：下载 libzip 源代码

访问 libzip 的官方网站或 GitHub 发布页面，获取最新稳定版本的源代码压缩包，以 libzip-1.9.2 版本为例：

cd /usr/local/src
sudo wget https://libzip.org/download/libzip-1.9.2.tar.gz
sudo tar -xvf libzip-1.9.2.tar.gz
cd libzip-1.9.2

步骤 3：配置、编译和安装

使用 cmake 来配置编译选项，然后使用 make 进行编译，最后使用 make install 将编译好的文件安装到系统中。

# 创建一个构建目录，保持源代码目录整洁
mkdir build && cd build
# 运行 cmake 进行配置，默认安装到 /usr/local
sudo cmake ..
# 开始编译，使用 -j 参数可以加速编译过程（-j4 表示使用4个CPU核心）
sudo make -j$(nproc)
# 安装到系统
sudo make install

安装完成后，库文件和头文件通常会被放置在 /usr/local/lib 和 /usr/local/include 目录下。

步骤 4：更新动态链接器缓存

编译安装到 /usr/local/lib 后，系统的动态链接器默认可能不知道这个新位置，需要手动更新缓存，以便程序能够找到新安装的 libzip 库。

echo '/usr/local/lib64' | sudo tee /etc/ld.so.conf.d/libzip.conf
sudo ldconfig

注意：在 64 位系统上，库文件通常在 lib64 目录，请确认 make install 后的实际路径，如果路径是 /usr/local/lib，则将上述命令中的 lib64 改为 lib。

步骤 5：验证编译安装

• 使用 pkg-config 验证：

  pkg-config --modversion libzip

  如果配置正确，此命令会输出您刚刚安装的版本号，9.2。

  

• 查找库文件：

  find /usr/local -name "libzip.so.*"

  您应该能看到新安装的库文件。

常见问题与故障排除

• 编译其他软件时提示找不到 libzip

  • 原因：很可能是因为没有安装 libzip-devel（YUM方式）或者 pkg-config 找不到 .pc 文件（源码方式）。
  • 解决：
    • YUM 安装：确保执行了 sudo yum install libzip-devel。
    • 源码安装：确保 /usr/local/lib64/pkgconfig 目录（或类似目录）存在于 PKG_CONFIG_PATH 环境变量中，或者在编译时手动指定库路径，LDFLAGS="-L/usr/local/lib64" CPPFLAGS="-I/usr/local/include"。

• 运行时提示 "error while loading shared libraries: libzip.so.5: cannot open shared object file"

  • 原因：动态链接器找不到 libzip.so.5 文件。
  • 解决：这通常发生在源码编译安装后，且没有正确执行 ldconfig 步骤，请检查 /etc/ld.so.conf.d/ 目录下是否有包含库路径的配置文件，并重新运行 sudo ldconfig。

相关问答 (FAQs)

我应该在什么时候选择 YUM 安装，什么时候选择源码编译安装？

解答： 这取决于您的具体需求。

• 选择 YUM 安装：如果您是系统管理新手，或者您的应用程序对 libzip 版本没有特殊要求，仅需要稳定可用即可，YUM 安装过程简单，易于管理和升级（通过 yum update）,是首选方案。
• 选择源码编译安装：当您的应用程序明确需要一个比 CentOS 7 官方仓库更新的 libzip 版本时（为了使用某个新特性或修复一个严重的安全漏洞），如果您需要对库的编译选项进行自定义（禁用某些功能）,编译安装是唯一的选择。

我已经通过源码编译安装了新版的 libzip，但系统中似乎还存在旧版本，这会有冲突吗？

解答： 通常情况下不会冲突，但需要理解系统是如何选择库的，动态链接器在加载库时会遵循一定的搜索顺序（/etc/ld.so.cache、/lib、/usr/lib 等），您通过源码安装的新版本默认位于 /usr/local/lib，而 YUM 安装的旧版本位于 /usr/lib64，通过将 /usr/local/lib64 路径添加到 /etc/ld.so.conf.d/ 并运行 ldconfig，系统会优先使用新版本，您可以使用 ldconfig -p | grep libzip 命令查看链接器缓存中记录的 libzip 库及其版本，确认哪个是默认被链接的，如果发现仍然链接到旧版，请检查 ld.so.conf.d 中的配置文件路径是否正确,并确保路径优先级高于系统默认路径。