phpEnv中Zip扩展默认未启用，需手动修改对应PHP版本的php.ini文件，取消extension=zip注释并重启环境，否则new ZipArchive()会报“Class 'ZipArchive' not found”错误。
phpEnv 环境下 Zip 扩展默认未启用，必须手动开启才能用 ZipArchive 类解压或压缩 ZIP 文件；否则调用 new ZipArchive() 会报错“Class 'ZipArchive' not found”。
phpEnv 中确认并开启 zip 扩展
phpEnv 是 Windows 下的便携式 PHP 集成环境（类似 XAMPP 的轻量版），其配置路径和常规 WAMP 不同，容易改错文件：
- 先确认当前 phpEnv 使用的是哪个 PHP 版本：打开 phpEnv 主界面 → 查看右上角显示的 PHP 版本号（如
PHP 8.2.12） - 对应找到该版本的
php.ini文件路径：通常为phpenv\versions\8.2.12\php.ini（路径含版本号，别进错目录） - 用记事本或 VS Code 打开该
php.ini，搜索;extension=zip—— 注意不是php_zip.dll，phpEnv 内置的扩展名就是zip - 去掉分号，改为
extension=zip，保存文件 - 在 phpEnv 界面点击「Restart」按钮（不是只重启 Apache，要整个环境重载），否则修改不生效
- 新建
test.php写入<?php var_dump(class_exists('ZipArchive'));，访问验证返回bool(true)
phpEnv 在线解压 ZIP 包的关键写法
很多教程直接抄 $zip->extractTo()，但在 phpEnv 下常因路径权限或相对路径出错，导致解压无声失败或只建空目录：
-
extractTo()的目标路径必须是**绝对路径**，且目录需已存在、有写入权限；建议用__DIR__ . '/unzip_here'而非'unzip_here' - ZIP 包本身路径也必须是绝对路径，
$zip->open('upload.zip')这种相对写法在 CLI 和 Web 下行为不一致，phpEnv 的 Web 模式下极易失败 - 务必检查
open()返回值：if ($zip->open($zipFile) !== \ZipArchive::ER_OK)，否则后续调用直接崩溃 - 如果 ZIP 含中文文件名或深层嵌套路径，phpEnv 默认的 PHP（尤其旧版）可能解压乱码或跳过文件；可加一行
mb_internal_encoding('UTF-8');提前声明编码 - 避免在根目录（如
C:\phpenv\www\）直接解压到../或/，phpEnv 的 Apache 配置默认禁止跨目录写入
常见错误现象与绕过方案
当 ZipArchive::extractTo() 看似执行成功但没生成文件时，不是代码问题，而是环境限制：
立即学习“PHP免费学习笔记（深入）”；
- 错误信息：
Warning: ZipArchive::extractTo(): Permission denied→ 检查目标目录是否被系统设为只读，或 phpEnv 进程无写权限（右键 phpEnv.exe → “以管理员身份运行”可临时解决） - 解压后文件名全是问号或乱码 → ZIP 原文件用 WinRAR/7-Zip 以 UTF-8 编码重新打包，或改用
getFromName()+file_put_contents()手动逐个解压并转码 -
ZipArchive::open()返回int(11)（即ZipArchive::ER_MEMORY）→ ZIP 文件过大（>100MB）或 phpEnv 分配内存不足，在php.ini中加大memory_limit = 512M并重启 - 想解压 RAR 或 7z？phpEnv 默认不支持 ——
ZipArchive只处理 ZIP 格式，RAR 需额外装RarArchive扩展（phpEnv 不预装，不推荐折腾）
真正卡住人的地方，往往不是语法，而是 phpEnv 把多个 PHP 版本的 php.ini 放在不同子目录里，改了 A 版本的却在 B 版本下测试；或者以为点了「Restart」就 reload 了配置，其实得关掉再打开主程序才彻底重载。
