PHP如何让ZipArchive提取ZIP内容到指定目标文件夹而非生成新文件夹？

不用先解压再重命名再压缩，直接遍历ZIP内的所有条目，修改每个条目的路径（替换原根目录为目标文件夹名），再逐个提取到目标位置，就能直接覆盖目标文件夹内容，无需中间步骤。

具体实现代码 #

$zip = new ZipArchive;
$targetDir = '/path/to/install/install_folder_name';
$res = $zip->open($new_version_zip);

if ($res === TRUE) {
    // 获取ZIP内的根目录名称
    $rootDir = '';
    // 遍历第一个有效条目，确定顶层目录
    for ($i = 0; $i < $zip->numFiles; $i++) {
        $entryName = $zip->getNameIndex($i);
        if (empty($entryName) || $entryName === '/') continue;
        
        $parts = explode('/', $entryName);
        $currentRoot = $parts[0];
        if (empty($rootDir)) {
            $rootDir = $currentRoot;
        } elseif ($currentRoot !== $rootDir) {
            die('ZIP包包含多个顶层目录，无法处理');
        }
        break;
    }

    // 处理ZIP直接包含文件的情况（无顶层目录）
    if (empty($rootDir)) {
        $zip->extractTo($targetDir);
    } else {
        // 遍历所有条目，修改路径后提取
        for ($i = 0; $i < $zip->numFiles; $i++) {
            $entryName = $zip->getNameIndex($i);
            // 跳过根目录本身的条目
            if ($entryName === $rootDir || $entryName === $rootDir . '/') continue;

            // 替换原根目录前缀，生成目标路径
            $newEntryPath = str_replace($rootDir . '/', '', $entryName);
            $targetPath = $targetDir . '/' . $newEntryPath;

            // 处理目录：递归创建不存在的目录
            if (substr($entryName, -1) === '/') {
                if (!is_dir($targetPath)) {
                    mkdir($targetPath, 0755, true);
                }
                continue;
            }

            // 处理文件：提取内容并写入目标路径（自动覆盖原有文件）
            $fileContent = $zip->getFromName($entryName);
            if ($fileContent !== false) {
                $parentDir = dirname($targetPath);
                if (!is_dir($parentDir)) {
                    mkdir($parentDir, 0755, true);
                }
                file_put_contents($targetPath, $fileContent);
            }
        }
    }

    $zip->close();
} else {
    die('无法打开ZIP包，错误码：' . $res);
}

代码说明 #

• 根目录识别：通过第一个有效条目确定ZIP的顶层目录，确保所有内容属于同一根目录（符合应用程序ZIP的常规结构）。
• 路径重映射：移除条目中的原根目录前缀，将内容直接映射到目标文件夹路径下。
• 文件与目录处理：自动创建所需的子目录，文件内容直接写入目标路径，覆盖原有文件。
• 异常处理：包含ZIP打开失败、多根目录的情况判断，可根据实际需求调整。

内容的提问来源于stack exchange，提问作者user3934058