php 8.2 在宝塔中报 class 'ziparchive' not found 是因 zip 扩展未编译进 php 实例，需重装 php 并勾选 zip 或手动编译扩展，同时确保系统已安装 libzip-devel 且版本 ≥ 1.8.0。
PHP 8.2 在宝塔面板里报 Class 'ZipArchive' not found，不是 PHP 版本问题，而是 zip 扩展压根没编译进当前 PHP 实例——宝塔默认安装 PHP 8.2 时确实可能跳过 zip（尤其 CentOS 7/8 或某些精简系统）。
确认 zip 扩展是否真的缺失
别急着装，先验证。进 SSH，执行：
php -m | grep zip
如果没输出，说明扩展未加载；再查编译参数：
php -i | grep "Configure Command"
看输出里有没有 --with-zip。没有？那它确实没被编译进去——pecl install zip 会失败，因为 pecl 的 zip 包依赖系统级 libzip 开发库，且要求 PHP 编译时已启用 zip 支持（PHP 8.0+ 的 zip 扩展已从源码树移出，必须靠编译时集成或使用 pecl + 正确依赖）。
用宝塔面板重装 PHP 并勾选 zip（推荐首选）
这是最稳、最兼容的方式。宝塔的 PHP 安装器会自动处理 libzip 版本匹配、头文件路径、configure 参数和 .so 加载配置。
- 登录宝塔 → 软件商店 → 找到已安装的
PHP-8.2→ 点击右侧「设置」→「安装扩展」 - 如果列表里没有
zip，说明当前 PHP 构建不含该模块支持 → 必须重装 - 回到软件商店 → 找到
PHP-8.2→ 点击「卸载」→ 卸载前勾选「保留网站配置」（不会删站点） - 重新安装
PHP-8.2→ 安装界面底部「编译参数」区域，务必勾选zip - 安装完成后，
php -m | grep zip应输出zip，php --ri zip可查看版本信息
手动编译 zip 扩展（仅当无法重装 PHP 时尝试）
此方式绕过宝塔 GUI，但风险高：libzip 版本不匹配会导致 php -v 报段错误，或 ZipArchive 类存在但方法调用崩溃。
- 先装系统依赖：
yum install -y libzip-devel（CentOS/RHEL）或apt install -y libzip-dev（Ubuntu/Debian） - 确认 libzip 版本 ≥ 1.8.0（PHP 8.2 要求）：
pkg-config --modversion libzip - 进入宝塔 PHP 源码目录（通常为
/www/server/php/82/src/ext/zip），运行：/www/server/php/82/bin/phpize - 然后：
./configure --with-php-config=/www/server/php/82/bin/php-config -
make && make install→ 成功后会提示Installing shared extensions:路径 - 编辑
/www/server/php/82/etc/php.ini，末尾加一行：extension=zip.so - 重启 PHP：
bt 16或在面板中重启
注意：pecl install zip 在 PHP 8.2 下基本不可用——pecl 仓库里的 zip 包已废弃，官方明确要求通过源码编译集成。
验证与常见故障点
装完别只信 php -m，得实测类可用性：
php -r "new ZipArchive(); echo 'OK';"
如果报 Class 'ZipArchive' not found，检查以下三项：
-
php.ini是否改对了？宝塔多 PHP 版本共存，确认修改的是/www/server/php/82/etc/php.ini，不是全局或其它版本 -
extension_dir路径是否正确？php --ini查加载的 ini 文件，再php --ri core | grep extension_dir看扩展目录是否指向ext子目录 - 是否漏了重启？宝塔里要「重启 PHP」，不是 reload，也不是只重启 Nginx/Apache
最常被忽略的是：宝塔安装 PHP 时若系统缺少 libzip-devel，即使勾选 zip，编译也会静默跳过——所以重装前务必先装好系统依赖。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
