报错:安装 PHP 7.4+ 时提示"系统缺少 libzip 库,版本需 ≥ 0.11"
问题描述
在尝试安装 PHP 7.4 或更高版本时,系统可能会提示错误信息:"系统缺少 libzip 库,版本需 ≥ 0.11"。这个错误通常出现在基于 CentOS 的系统上,尤其是 CentOS 7,它会阻止 PHP 的正常安装过程。
原因分析
这个错误产生的主要原因是 CentOS 7 系统默认自带的 libzip 库版本过低(通常仅为 0.10 版本),而 PHP 7.4 及更高版本要求系统中安装的 libzip 库版本必须达到 0.11 或以上。由于系统默认软件源中的 libzip 版本无法满足这一要求,因此导致了安装失败的情况。
解决方案
针对这个问题,有两种有效的解决方法:
方法一:手动编译安装高版本 libzip
-
首先下载最新版本的 libzip 源码包:
wget https://libzip.org/download/libzip-1.9.2.tar.gz
-
解压并进入源码目录:
tar -zxvf libzip-1.9.2.tar.gz cd libzip-1.9.2
-
编译并安装:
./configure make make install
-
更新系统动态链接库缓存:
echo '/usr/local/lib' > /etc/ld.so.conf.d/local.conf ldconfig -v
完成以上步骤后,系统中的 libzip 库将被更新为满足 PHP 要求的版本,此时可以重新尝试安装 PHP。
方法二:使用宝塔提供的"编译依赖修复工具"
如果您使用的是宝塔面板,可以更简单地解决这个问题:
- 登录宝塔面板管理后台
- 找到并打开"软件商店"
- 选择"运行环境"分类
- 点击 PHP 版本右侧的"设置"按钮
- 在弹出的菜单中,选择"编译依赖修复工具"
- 按照提示完成修复过程
宝塔的"编译依赖修复工具"会自动检测并修复包括 libzip 在内的各种编译依赖问题,无需手动操作,更加方便快捷。
通过以上任一方法解决 libzip 版本问题后,您就可以顺利安装 PHP 7.4 或更高版本了。