宝塔PHP安装zip扩展失败解决方法
2026-05-12 17:25:19
0浏览
收藏
宝塔面板安装PHP zip扩展频频失败?问题八成出在libzip库——要么系统压根没装,要么版本过旧不兼容,导致出现“configure: error: zip support requires libzip”或“cannot find libzip”等报错;只需手动编译安装适配的libzip版本,并建立关键的zipconf.h软链接,即可彻底解决安装卡顿,让zip扩展顺利启用。

为什么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安装zip扩展失败解决方法》,希望本文对你有所帮助!关注golang学习网公众号,给大家分享更多文章知识!
DeepSeek手机快捷键设置与小组件添加教程
- 上一篇
- DeepSeek手机快捷键设置与小组件添加教程
- 下一篇
- 天眼查如何查公司法人?详细教程分享
查看更多
最新文章
-
- 文章 · php教程 | 29分钟前 | 反射 · 标准库 · 面向对象 · php教程 · php 反射 类常量 ReflectionClassConstant getDeclaringClass
- PHP ReflectionClassConstant.getDeclaringClass 怎样取得常量真正声明所在的类
- 287浏览 收藏
-
- 文章 · php教程 | 1小时前 | 反射 · PHP · php ReflectionParameter getPosition 形参位置
- PHP ReflectionParameter.getPosition 怎样读取形参在声明中的从零序号
- 269浏览 收藏
-
- 文章 · php教程 | 2小时前 | 反射 · 常量 · PHP · php ReflectionParameter 参数默认值 isDefaultValueConstant
- PHP ReflectionParameter.isDefaultValueConstant 怎样判断参数默认值是否来自常量
- 462浏览 收藏
-
- 文章 · php教程 | 3小时前 |
- PHP ReflectionFunctionAbstract.getAttributes 怎样按属性类名筛选函数属性
- 135浏览 收藏
-
- 文章 · php教程 | 10小时前 |
- PHP IntlCalendar setTimeZone 怎样转换时区仍保持同一时间点
- 333浏览 收藏
-
- 文章 · php教程 | 10小时前 | 常量 · PHP · php get_defined_constants 扩展常量 user常量 常量分组
- PHP get_defined_constants 怎样按扩展分组查看常量
- 242浏览 收藏
-
- 文章 · php教程 | 10小时前 | php教程 · php Parse NumberFormatter
- PHP NumberFormatter 怎样取得数字解析结束位置
- 106浏览 收藏
-
- 文章 · php教程 | 10小时前 | PHP · php 国际化 浏览器语言 Accept-Language Locale::acceptFromHttp
- PHP Locale.acceptFromHttp 怎样读取浏览器语言偏好
- 299浏览 收藏
-
- 文章 · php教程 | 10小时前 | 性能监控 · PHP · php 服务器监控 sys_getloadavg 系统负载 运行队列
- PHP sys_getloadavg 怎样读取系统负载三个时间窗口
- 198浏览 收藏
-
- 文章 · php教程 | 10小时前 |
- PHP get_defined_vars 怎样查看当前作用域变量
- 351浏览 收藏
-
- 文章 · php教程 | 10小时前 | 流式处理 · PHP · php xml 流式读取 XMLReader XMLReader::read
- PHP XMLReader::read 怎样逐节点处理大型 XML 文件
- 112浏览 收藏
查看更多
课程推荐
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
查看更多
AI推荐
-
- PubMedQA
- 深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
- 1095次使用
-
- H2O EvalGPT
- H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
- 1091次使用
-
- LMArena
- LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
- 1256次使用
-
- HELM
- 深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
- 1197次使用
-
- MMBench
- MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
- 1045次使用
查看更多
相关文章
-
- PHP fgetcsv escape 参数显式设置与 RFC 4180 兼容处理
- 2026-10-26 501浏览
-
- PHP JSON_THROW_ON_ERROR 抛错后怎么保留原始字段位置
- 2026-09-09 501浏览
-
- PHP 8.5 array_last() 怎么处理空数组:从 null 结果到兼容旧版本的 Polyfill
- 2026-08-16 501浏览
-
- 宝塔配置Ruby环境:RVM+Nginx反代教程
- 2026-05-29 501浏览
-
- unset函数作用范围详解
- 2026-05-29 501浏览

