确认ZIP扩展是否已启用需访问http://localhost/dashboard/phpinfo.php搜索zip，若显示“zip support → enabled”和“Zip Archive → enabled”即成功；否则需按系统类型手动启用：Windows下解除php.ini中extension=zip注释并确认php_zip.dll存在，Linux下LAMPP须用自带phpize编译安装zip.so。
确认 ZIP 扩展是否已启用
直接访问 http://localhost/dashboard/phpinfo.php，在页面中搜索 zip。如果看到 “zip support → enabled” 和 “Zip Archive → enabled”，说明扩展已加载；若没出现或显示 disabled，则需手动启用。
常见错误现象：调用 new \ZipArchive() 时抛出 Fatal error: Class 'ZipArchive' not found —— 这不是代码问题，是扩展根本没加载。
- Windows 下 XAMPP 默认多数版本已内置
php_zip.dll，但常被注释掉 - Linux 下 XAMPP（即 LAMPP）不自带 zip 扩展，必须手动编译安装，不能只改 php.ini
- 注意区分
php.ini路径：XAMPP 控制面板里点 “Config → PHP (php.ini)” 才是 Apache 实际加载的配置文件，别改错位置
Windows：解除注释并验证 DLL 存在
打开 XAMPP 对应的 php.ini（通常是 C:\xampp\php\php.ini），搜索 extension=zip：
- 若找到
;extension=zip，删掉开头分号，改为extension=zip - 若找不到这行，手动添加在
;extension=openssl附近（确保在所有extension=区块内） - 检查
C:\xampp\php\ext\目录下是否存在php_zip.dll—— 缺失会导致 Apache 启动失败或报PHP Warning: Unable to load dynamic library 'php_zip.dll' - 保存后，必须重启 Apache（不是仅刷新页面），否则修改不生效
Linux（LAMPP）：必须手动编译 zip 扩展
Linux 版 XAMPP（/opt/lampp）不提供预编译的 zip.so，apt install php-zip 无效 —— 它装的是系统 PHP 的扩展，和 LAMPP 自带的 PHP 无关。
XAMPP 8.0.30 是一款免费、开源的跨平台 Web 服务器集成包，专为快速搭建本地 PHP 开发环境而设计。该版本核心组件包括：Apache 2.4.56、MySQL 8.0.33、PHP 8.0.30、phpMyAdmin 5.2.1 等。它支持 Windows、Linux 和 macOS 系统，可让开发者在个人电脑上轻松模拟服务器环境，无需复杂配置即可运行 WordPress、Thin
正确做法是用 LAMPP 自带的工具链编译：
- 先确认 PHP 版本：
/opt/lampp/bin/php -v - 下载对应版本的 PECL zip 源码（如
zip-1.22.3.tgz），解压进入目录 - 执行：
/opt/lampp/bin/phpize→./configure --with-php-config=/opt/lampp/bin/php-config→make && sudo make install - 编辑
/opt/lampp/etc/php.ini，添加extension=zip.so - 重启：
sudo /opt/lampp/lampp restart
漏掉 --with-php-config 参数会导致扩展加载后报 undefined symbol: zend_parse_parameters —— 这是最常踩的坑。
在线解压功能依赖 ZIP 扩展，但不止于此
像 kodexplorer 这类 Web FTP 工具能“在线解压”，底层调用的是 ZipArchive::open() + extractTo()，所以 ZIP 扩展只是前提。还需注意：
-
open()的第二个参数必须是\ZipArchive::CREATE（压缩）或\ZipArchive::RDONLY（解压），传整数1或0会静默失败 - 目标路径权限：Web 服务器用户（如
daemon或www-data）必须对解压目录有写权限，否则extractTo()返回false且无提示 - 大文件解压可能超时：需同步调整
max_execution_time和memory_limit，否则中途中断且 zip 文件残留锁
真正卡住的地方往往不是“怎么开 ZIP”，而是解压时权限不对、路径没写全、或者用了相对路径却没 chdir 到正确工作目录 —— 这些比扩展本身更难排查。
