ziparchive类在phpenv中需先启用扩展并重启服务，再处理open_basedir限制、内存超时及路径穿越风险。
phpEnv 下的 PHP 7.4 要用 ZipArchive 类做文件管理（比如在线压缩/解压），第一步不是写代码，而是确保 ZipArchive 类能被 new 出来——否则直接报 Class 'ZipArchive' not found，后续全白搭。
确认当前 phpEnv 使用的 PHP 7.4 版本号及对应 php.ini 路径
phpEnv 是多版本共存环境，改错配置文件等于白忙。必须先定位真实生效的配置：
- 打开 phpEnv 控制面板 → 右上角「PHP版本」下拉菜单，记下你站点实际绑定的版本（例如
7.4.33、7.4.28） - 对应
php.ini路径固定为：E:/phpEnv/php/{版本号}/php.ini（Windows）或/usr/local/phpenv/php/{版本号}/php.ini（Linux/macOS 模拟环境） - 别去改 phpEnv 主目录下的通用
php.ini，它不参与运行时扩展加载
启用 zip 扩展：只改一行，但必须重启 Web 服务
编辑上面确认的 php.ini，搜索 zip，找到这一行：
;extension=zip
去掉分号，保存。注意三点：
- 不要写成
extension=php_zip.dll（Windows）或extension=zip.so（Linux/macOS）——phpEnv 预编译包已内置适配，统一用extension=zip - 改完不重启服务 = 没生效。必须点击 phpEnv 控制面板里的「重启 Apache」或「重启 Nginx」，不是仅重启 PHP-FPM
- 验证方式：建一个
info.php，内容为<?php phpinfo(); ?>，访问后搜索zip support，看到enabled和Libzip version才算成功
ZipArchive 压缩/解压脚本在 phpEnv 中跑不通的两个硬限制
即使 phpinfo() 显示 zip 已启用，Web 端调用仍可能失败，主因是 phpEnv 默认安全策略太紧：
-
open_basedir限制：默认只允许读写E:/phpEnv/www/及其子目录。若脚本尝试压缩E:/temp/data或解压到../backup，会触发file_exists(): open_basedir restriction错误。解决方法：在站点对应的 Apache/Nginx 配置中注释掉php_admin_value open_basedir行，或把所有待处理文件移到www子目录内 - 超时与内存：phpEnv 默认
max_execution_time=30、memory_limit=128M，压缩大目录极易报Fatal error: Allowed memory size exhausted。可在脚本开头加：set_time_limit(0); ini_set('memory_limit', '512M');，但仅限可信后台使用，切勿开放给前端表单
ZipArchive::extractTo() 解压时路径穿越风险必须手动拦截
phpEnv 不自动过滤 ZIP 包里的恶意路径（如 ../../etc/passwd），直接调用 $zip->extractTo() 可能导致文件写入 Web 目录外。必须自己校验每个条目名：
$zip = new ZipArchive();
if ($zip->open($zipFile) === ZIPARCHIVE::ER_OK) {
for ($i = 0; $i numFiles; $i++) {
$name = $zip->getNameIndex($i);
// 关键校验：拒绝含 ../ 或以 / 开头的路径
if (strpos($name, '..') !== false || $name[0] === '/') {
continue;
}
$target = __DIR__ . '/unzip/' . $name;
// 确保目标路径仍在允许范围内
if (realpath($target) !== false && strpos(realpath($target), __DIR__) === 0) {
$zip->extractTo(__DIR__ . '/unzip/', [$name]);
}
}
$zip->close();
}
这个校验逻辑不能省——phpEnv 的 Web 进程权限虽低，但路径穿越一旦绕过，就可能覆盖配置文件或写入 Webshell。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
