PHP无法从ZIP归档中提取文件问题求助

问题分析 #

你遇到的核心问题：

• 自定义解压函数用copy通过zip://协议读取文件时，因路径解析或权限问题失败
• 使用extractTo无报错但无文件生成，大概率是路径未正确解析或权限不足导致

修复后的完整代码 #

上传与路径处理（先确保路径正确） #

// 将相对路径转为绝对路径，避免解析歧义
$path = realpath($path) . DIRECTORY_SEPARATOR;
$target_Path = $path . basename($_FILES['file']['name']);

// 校验文件上传是否成功
if (!move_uploaded_file($_FILES['file']['tmp_name'], $target_Path)) {
    die('文件上传失败，请检查上传目录权限');
}

修正后的解压函数 #

function unzip($zipFile, $destination) {
    // 统一转为绝对路径，解决相对路径解析问题
    $zipFile = realpath($zipFile);
    $destination = realpath($destination) . DIRECTORY_SEPARATOR;

    $zip = new ZipArchive();
    $status = $zip->open($zipFile);
    
    // 必须校验Zip文件打开状态，排查核心问题
    if ($status !== true) {
        $errorMsg = match($status) {
            ZipArchive::ER_EXISTS => 'Zip文件已存在且无法覆盖',
            ZipArchive::ER_INCONS => 'Zip文件损坏，请重新上传',
            ZipArchive::ER_NOENT => '指定的Zip文件不存在',
            ZipArchive::ER_NOZIP => '上传的文件不是有效的Zip格式',
            ZipArchive::ER_OPEN => '无法打开Zip文件，检查文件权限',
            default => 'Zip打开失败，状态码：' . $status
        };
        die($errorMsg);
    }

    // 优先使用官方extractTo方法，简洁可靠
    if ($zip->extractTo($destination)) {
        echo '文件解压成功';
    } else {
        // 若extractTo失败，降级为逐个文件提取（更稳定）
        for ($i = 0; $i < $zip->numFiles; $i++) {
            $file = $zip->getNameIndex($i);
            // 跳过目录项
            if (substr($file, -1) === '/') continue;

            $targetFile = $destination . $file;
            $targetDir = dirname($targetFile);

            // 创建目标目录（确保权限生效）
            if (!is_dir($targetDir)) {
                umask(0);
                if (!mkdir($targetDir, 0777, true)) {
                    die('无法创建目录：' . $targetDir);
                }
            }

            // 使用ZipArchive内置方法读取内容并写入，替代copy避免协议路径问题
            $fileContent = $zip->getFromName($file);
            if ($fileContent === false) {
                die('读取Zip内文件失败：' . $file);
            }
            if (!file_put_contents($targetFile, $fileContent)) {
                die('写入文件失败：' . $targetFile);
            }
            echo '已提取文件：' . $targetFile . '<br>';
        }
    }

    $zip->close();
}

// 调用解压函数
unzip($target_Path, $path);

关键修复点说明 #

1. 绝对路径转换：用realpath()将所有相对路径转为绝对路径，彻底避免不同运行环境下的路径解析错误（这是extractTo无反应的常见原因）
2. Zip打开状态校验：通过判断open()的返回值，直接定位是文件损坏、权限不足还是格式错误
3. 替代copy方法：用ZipArchive::getFromName()读取文件内容，再通过file_put_contents()写入，避开zip://协议的路径兼容性问题
4. 权限处理：创建目录前设置umask(0)，确保0777权限生效，避免因系统默认掩码导致的写入失败

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