如何在Laravel中从S3下载文件夹并打包为ZIP文件

现有代码的核心问题 #

• 未将ZipArchive实例赋值给$zip变量，后续调用方法会直接报错
• $filename变量未定义，多处引用会触发未定义变量错误
• 仅处理单个文件，未实现文件夹批量打包的核心逻辑
• 错误使用file_get_contents直接读取S3路径，应通过Laravel Storage的get方法获取文件内容
• 缺少错误处理（如ZIP文件打开失败、S3文件读取失败）
• 临时ZIP文件使用后未清理，会持续占用服务器磁盘空间

修正后的完整实现 #

// 初始化ZipArchive实例
$zip = new \ZipArchive();
$zipFilename = sys_get_temp_dir() . '/Admissionform_' . $school_id . '_' . $formfor_id . '.zip';

// 处理ZIP文件打开失败的情况
if ($zip->open($zipFilename, \ZipArchive::CREATE) !== true) {
    die('无法创建ZIP压缩文件');
}

$s3 = Storage::disk('s3');
$mainPath = 'your-target-s3-folder-path'; // 替换为实际的S3文件夹路径

// 检查目标文件夹是否存在
if ($s3->exists($mainPath)) {
    // 获取文件夹下所有文件（递归包含子文件夹内的文件）
    $files = $s3->allFiles($mainPath);

    foreach ($files as $filePath) {
        // 读取S3文件内容
        $fileContent = $s3->get($filePath);
        
        // 生成ZIP内的相对路径，保持原文件夹结构
        $relativePath = str_replace($mainPath . '/', '', $filePath);
        
        // 将文件内容添加到ZIP
        if (!$zip->addFromString($relativePath, $fileContent)) {
            die('添加文件 ' . $relativePath . ' 到ZIP失败');
        }
    }
}

// 关闭ZIP文件
$zip->close();

// 设置响应头，触发浏览器下载
header('Content-Disposition: attachment; filename="Admissionform_' . $school_id . '_' . $formfor_id . '.zip"');
header('Content-Type: application/zip');
header('Content-Length: ' . filesize($zipFilename));

// 输出ZIP内容到浏览器
readfile($zipFilename);

// 清理服务器上的临时ZIP文件
unlink($zipFilename);
exit;

后续操作说明 #

• 替换代码中的$mainPath为你实际要下载的S3文件夹路径（例如'schools/' . $school_id . '/admission-forms'）
• 确认Laravel的S3磁盘配置正确，在config/filesystems.php中已填写正确的S3密钥、桶名等信息
• 可选但推荐：添加try-catch异常捕获逻辑，替换die语句为更友好的错误响应（比如JSON格式提示）
• 如果目标文件夹内文件数量多或体积大，可设置内存限制（如ini_set('memory_limit', '256M')），避免内存溢出

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