处理大Zip文件的PHP代码性能优化方案咨询

你的代码功能逻辑方向正确，但存在几个核心问题导致处理80MB的Zip文件速度极慢，甚至可能产生错误的输出文件，以下是具体问题分析和优化方案：

原代码的核心问题 #

1. 致命逻辑错误：调用$newZip->addFile($fileZipToExtract, $basename)时，第一个参数传入的是整个源Zip文件的路径，这意味着循环的每一次都会把80MB的源文件完整添加到新Zip中，不仅完全达不到“提取根目录内文件”的目的，还会导致新Zip体积暴增，I/O操作量爆炸，这是速度慢的根本原因。
2. 未定义变量：代码中引用了未初始化的$stream变量，存在语法错误。
3. 冗余字符串处理：循环内频繁调用pathinfo、重复执行strpos和substr，增加了不必要的计算开销。
4. 不必要的校验：开启了ZipArchive::CHECKCONS选项，该选项会对每个文件做额外的一致性校验，大幅拖慢处理速度。

优化方案 #

方案一：修复ZipArchive逻辑，高效复制压缩项 #

利用PHP的ZipArchiveAPI直接复制源Zip中的文件项（PHP 8.0+支持更高效的copyFile方法），避免重复读取整个源文件：

$zipFilename = 'file-' . date('Y-m-d-H-i-s') . ".zip";
$tmpDir = dirname(__DIR__) . '/temp';
$zipPath = $tmpDir . '/' . $zipFilename;

// 确保临时目录存在，避免报错
if (!is_dir($tmpDir)) {
    mkdir($tmpDir, 0755, true);
}

$fileZip = new ZipArchive();
if ($fileZip->open($fileZipToExtract) === true) {
    $newZip = new ZipArchive();
    // 移除CHECKCONS选项，关闭无压缩（如果不需要的话）
    if ($newZip->open($zipPath, ZipArchive::CREATE | ZipArchive::OVERWRITE) !== true) {
        $fileZip->close();
        die("无法创建目标Zip文件");
    }

    // 获取根目录，确保以/结尾（兼容GitLab导出的Zip格式）
    $rootDir = $fileZip->getNameIndex(0);
    if (substr($rootDir, -1) !== '/') {
        $rootDir .= '/';
    }
    $rootDirLen = strlen($rootDir);

    for ($i = 0; $i < $fileZip->numFiles; $i++) {
        $filename = $fileZip->getNameIndex($i);
        
        // 跳过根目录本身
        if ($filename === $rootDir) {
            continue;
        }

        // 只处理根目录下的文件/文件夹
        if (strpos($filename, $rootDir) === 0) {
            $newFilename = substr($filename, $rootDirLen);
            
            // 处理文件夹（添加空目录，可选）
            if (substr($filename, -1) === '/') {
                $newZip->addEmptyDir($newFilename);
                continue;
            }

            // PHP 8.0+用copyFile直接复制压缩数据，无需解压，性能最优
            if (method_exists($fileZip, 'copyFile')) {
                $fileZip->copyFile($filename, $newZip, $newFilename);
            } else {
                // 兼容低版本PHP，读取文件内容后添加
                $content = $fileZip->getFromIndex($i);
                if ($content !== false) {
                    $newZip->addFromString($newFilename, $content);
                }
            }
        }
    }

    $newZip->setArchiveComment('File generated at ' . date('Y-m-d H:i:s'));
    $newZip->close();
    $fileZip->close();
}

方案二：使用系统命令（性能天花板） #

如果服务器允许执行系统命令，直接用unzip和zip命令处理，速度远快于PHP的ZipArchive，因为这些工具是原生C实现的，I/O效率极高：

$zipFilename = 'file-' . date('Y-m-d-H-i-s') . ".zip";
$tmpDir = dirname(__DIR__) . '/temp';
$extractDir = $tmpDir . '/extract_' . uniqid();
$zipPath = $tmpDir . '/' . $zipFilename;

// 创建临时解压目录
mkdir($extractDir, 0755, true);

// 安全转义路径，避免命令注入
$srcZip = escapeshellarg($fileZipToExtract);
$extractDest = escapeshellarg($extractDir);
// 静默解压到临时目录
exec("unzip -q $srcZip -d $extractDest");

// 获取解压后的根目录（GitLab导出的Zip只有一个根文件夹）
$rootDir = glob($extractDir . '/*', GLOB_ONLYDIR)[0];
$rootDirEscaped = escapeshellarg($rootDir);
$targetZip = escapeshellarg($zipPath);
// 从根目录下打包所有内容
exec("cd $rootDirEscaped && zip -q -r $targetZip .");

// 清理临时文件
array_map('unlink', glob("$extractDir/*"));
rmdir($extractDir);

额外优化建议 #

• 把临时目录设置在内存文件系统（比如/tmp，很多服务器是tmpfs），减少磁盘I/O瓶颈。
• 去掉原代码中$fileInfo['extension']的判断，该逻辑会跳过无扩展名的文件（如README、LICENSE），如果不需要这个过滤可以删除，减少循环内的判断开销。
• 如果不需要无压缩输出，移除ZipArchive::CM_STORE选项，让ZipArchive使用默认的DEFLATE压缩，体积更小且速度不会有明显下降。

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