当前位置：首页 > 文章列表 > 文章 > php教程 > PHP使用ZipArchive解压ZIP文件方法

PHP使用ZipArchive解压ZIP文件方法

2026-01-29 12:15:40 0浏览收藏

大家好，我们又见面了啊~本文《PHP使用ZipArchive解压ZIP文件教程》的内容中将会涉及到等等。如果你正在学习文章相关知识，欢迎关注我，以后会给大家带来更多文章相关文章，希望我们能一起进步！下面就开始本文的正式内容~

ZipArchive::extractTo() 是 PHP 原生解压 ZIP 的核心方法，需确保目标目录存在且有写权限，手动校验路径防穿越，并检查 open() 返回值与错误码。

php怎么解压文件_ziparchive解压zip文件的代码示例【教程】

ZipArchive::extractTo() 是解压 ZIP 的核心方法

PHP 原生解压 ZIP 文件，最可靠的方式是用 ZipArchive 类的 extractTo() 方法。它不依赖外部命令，跨平台稳定，且能精确控制解压路径和文件过滤。

关键前提是：目标目录必须已存在且 PHP 有写权限；否则 extractTo() 会静默失败（返回 false），不会自动创建父级目录。

open() 成功后必须检查返回值，ZIPARCHIVE::ER_NOZIP、ZIPARCHIVE::ER_READ 等错误码要单独处理
解压前建议用 getFromName() 或遍历 statIndex() 预检文件名，避免路径穿越（如 ../etc/passwd）
PHP 8.0+ 默认禁用相对路径解压，但旧版本仍需手动过滤含 ../ 的 getNameIndex() 结果

完整可运行的解压代码示例

以下代码包含基础解压、错误判断、路径安全校验三要素，适用于 PHP 7.4+：

$zip = new ZipArchive();
$res = $zip->open('/path/to/archive.zip');
if ($res !== true) {
    throw new RuntimeException("无法打开 ZIP 文件，错误码: $res");
}

// 创建目标目录（仅当不存在时）
$destDir = '/path/to/extract/';
if (!is_dir($destDir)) {
    if (!mkdir($destDir, 0755, true)) {
        throw new RuntimeException("无法创建解压目录: $destDir");
    }
}

// 遍历并安全解压每个文件
for ($i = 0; $i numFiles; $i++) {
    $filename = $zip->getNameIndex($i);
    // 拒绝含 ../ 或以 / 开头的路径（防路径穿越）
    if (str_starts_with($filename, '/') || str_contains($filename, '../')) {
        continue;
    }
    $fullPath = $destDir . ltrim($filename, '/');
    $dir = dirname($fullPath);
    if (!is_dir($dir)) {
        mkdir($dir, 0755, true);
    }
}
$zip->extractTo($destDir);
$zip->close();