ZipArchive扩展依赖libzip库，CentOS 7等系统自带libzip版本过低（如0.10.x），PHP 7.4+要求≥0.11且排除问题版本；需卸载旧包、从libzip.org下载1.9.2源码编译，并通过PKG_CONFIG_PATH或--with-libzip=显式指定路径确保PHP configure正确识别。
ZipArchive 扩展依赖系统级 libzip 库，不是装个 php-zip 包就能用的。CentOS 7 / AlmaLinux / Rocky 等系统自带的 libzip 版本太老（通常 0.10.x），而 PHP 7.4+ 要求 libzip >= 0.11 且明确排除 1.3.1、1.7.0 等有 ABI 问题的版本——所以直接 yum install libzip-devel 会卡在 configure 阶段报错。
configure 报错 “Package 'libzip' not found” 怎么办
这是最常见现象：PHP ./configure --with-zip 找不到满足要求的 libzip。根本原因不是没装，而是装了旧版或没暴露给 pkg-config。
- 先确认是否残留旧包：
rpm -q libzip libzip-devel，如果输出版本是0.10.1或1.3.1，必须卸载：yum remove libzip libzip-devel - 不要用
apt-get或dnf装第三方源的“新版”，很多镜像打包不规范，.pc文件路径错、符号链接漏、libzip.so版本号不匹配，照样失败 - 必须从 libzip.org 下载源码编译，推荐
libzip-1.9.2.tar.xz（截至 2026 年 4 月最新稳定版） - 编译后务必验证：
pkg-config --modversion libzip输出应为1.9.2；pkg-config --libs libzip应返回含-L/usr/local/lib的链接参数
cmake 编译时提示 “undefined reference to `inflate`”
这是 zlib 未正确链接的典型错误。libzip 依赖 zlib，但 cmake 默认可能找不到你系统里已装的 zlib 开发文件，或交叉编译时路径混乱。
- 确保已装 zlib 开发包：
yum install zlib-devel（CentOS/RHEL）或apt-get install zlib1g-dev（Debian/Ubuntu） - cmake 命令中显式指定 zlib 路径更可靠：
cmake -DZLIB_INCLUDE_DIR=/usr/include -DZLIB_LIBRARY=/usr/lib64/libz.so .. - 如果 zlib 是自己编译安装在
/opt/zlib，就对应改成-DZLIB_INCLUDE_DIR=/opt/zlib/include -DZLIB_LIBRARY=/opt/zlib/lib/libz.so - 别跳过
make && make install后的ldconfig刷新：echo '/usr/local/lib' > /etc/ld.so.conf.d/libzip.conf && ldconfig
pkg-config 找不到 libzip.pc 却说 “install 成功”
make install 默认把 libzip.pc 放进 /usr/local/lib/pkgconfig/，但多数系统默认只查 /usr/lib64/pkgconfig 和 /usr/share/pkgconfig。
- 检查文件是否存在：
ls -l /usr/local/lib/pkgconfig/libzip.pc - 临时生效：
export PKG_CONFIG_PATH="/usr/local/lib/pkgconfig:$PKG_CONFIG_PATH" - 永久生效：写入 shell 配置，例如
echo 'export PKG_CONFIG_PATH="/usr/local/lib/pkgconfig:$PKG_CONFIG_PATH"' >> ~/.bash_profile && source ~/.bash_profile - 验证是否加载：
pkg-config --list-all | grep zip应该输出libzip行 - 注意：PHP configure 运行时读的是当前 shell 的
PKG_CONFIG_PATH，不是 root 的——切到编译 PHP 的用户下再试
重新编译 PHP 时仍提示 libzip 版本不满足
即使 pkg-config 显示正常，PHP configure 仍可能报 libzip != 1.3.1 这类排除性错误，说明它实际调用的 pkg-config 没走对路径，或缓存未刷新。
立即学习“PHP免费学习笔记（深入）”；
- 在 PHP 源码目录下执行：
./configure --with-zip --with-libzip=/usr/local（显式指定前缀，绕过 pkg-config 查找） - 清空上次 configure 生成的缓存：
make clean（如果之前 build 过） + 删除config.cache文件 - 运行 configure 时加
--debug参数看它到底在哪儿找libzip：./configure --with-zip --debug 2>&1 | grep -A5 -B5 libzip - 如果用了
php-build或phpenv工具，确认其环境变量是否覆盖了你的PKG_CONFIG_PATH
libzip 的坑不在编译本身，而在“看似装好了，其实没被 PHP 看见”。关键动作只有三步：卸干净旧包、用 cmake 指定 zlib 路径装新包、用 PKG_CONFIG_PATH 或 --with-libzip= 让 PHP configure 精准定位。中间任何一环路径错位或环境变量失效，都会回到原点。 
