Laravel多文件打包下载教程：利用ZipArchive高效处理文件集合

use Illuminate\Http\Request;
use Illuminate\Support\Facades\DB;

class FileController extends Controller
{
    public function create(Request $request)
    {
        // 验证文件上传，确保是文件类型且符合大小等要求
        $request->validate([
            'attachment_name.*' => 'required|file|max:2048', // 示例验证规则
        ]);

        $datatest = [];
        if ($request->hasFile('attachment_name')) {
            foreach ($request->file('attachment_name') as $file) {
                // 生成唯一文件名，防止重复
                $name = date('dmYHis') . '-' . uniqid() . '.' . $file->getClientOriginalExtension();
                // 将文件移动到指定目录
                $file->move(public_path('storage/file/'), $name);
                $datatest[] = $name;
            }
        }

        // 将文件名数组用管道符 "|" 连接成字符串
        $insert['attachment_name'] = implode("|", $datatest);

        // 将数据插入数据库
        DB::table('media_order')->insert($insert);

        return redirect()->back()->with('success', '文件上传成功！');
    }
}

use Illuminate\Support\Facades\DB;
use Illuminate\Support\Facades\Response;

class FileController extends Controller
{
    public function downloadSingle($id)
    {
        try {
            $record = DB::table('media_order')->where('id', $id)->first();

            if ($record && $record->attachment_name) {
                // 假设 attachment_name 此时只包含一个文件名
                $fileName = $record->attachment_name;
                $filePath = public_path('storage/file/') . $fileName;

                if (file_exists($filePath)) {
                    return Response::download($filePath, $fileName);
                } else {
                    return response()->json(['error' => '文件不存在'], 404);
                }
            }
            return response()->json(['error' => '记录或文件名不存在'], 404);
        } catch (\Exception $e) {
            \Log::error("下载单文件时发生错误: " . $e->getMessage());
            return response()->json(['error' => '下载失败: ' . $e->getMessage()], 500);
        }
    }
}

use Illuminate\Support\Facades\DB;
use Illuminate\Support\Facades\Response;
use ZipArchive; // 引入 ZipArchive 类
use Illuminate\Support\Facades\Log; // 用于日志记录

class FileController extends Controller
{
    public function downloadMultiple($id)
    {
        // 1. 定义生成的ZIP文件的存储路径和文件名
        // 建议使用唯一文件名，以避免并发下载时文件名冲突
        $zipFileName = 'downloaded_files_' . $id . '_' . time() . '.zip';
        $zipFilePath = public_path('storage/file/') . $zipFileName; // ZIP文件将存储在此路径

        $zip = new ZipArchive();

        try {
            // 2. 尝试创建并打开ZIP文件
            // ZipArchive::CREATE 如果文件不存在则创建，ZipArchive::OVERWRITE 如果文件存在则覆盖
            if ($zip->open($zipFilePath, ZipArchive::CREATE | ZipArchive::OVERWRITE) !== TRUE) {
                Log::error("无法创建压缩文件: " . $zipFilePath);
                return response()->json(['error' => '无法创建压缩文件'], 500);
            }

            // 3. 从数据库获取记录
            $record = DB::table('media_order')->where('id', $id)->first();

            if ($record && $record->attachment_name) {
                // 4. 将管道符分隔的文件名字符串拆分成数组
                $fileNames = explode("|", $record->attachment_name);
                $sourceFilesDirectory = public_path('storage/file/'); // 原始文件所在的目录

                // 5. 遍历文件名数组，将每个文件添加到ZIP中
                foreach ($fileNames as $fileName) {
                    $fullFilePath = $sourceFilesDirectory . $fileName;

                    // 确保文件存在，防止添加不存在的文件导致错误
                    if (file_exists($fullFilePath)) {
                        // addFile(文件在服务器上的完整路径, 文件在ZIP中的名称)
                        $zip->addFile($fullFilePath, $fileName);
                    } else {
                        Log::warning("文件不存在，无法添加到压缩包: " . $fullFilePath);
                        // 可以选择跳过或返回错误
                    }
                }
            } else {
                // 如果没有找到记录或没有附件名，关闭ZIP文件并删除（如果已创建）
                if (file_exists($zipFilePath)) {
                    $zip->close();
                    unlink($zipFilePath);
                }
                return response()->json(['error' => '没有找到相关文件记录'], 404);
            }

            // 6. 关闭ZIP文件，完成写入操作
            $zip->close();

            // 7. 将生成的ZIP文件发送给用户下载
            // deleteFileAfterSend(true) 会在文件发送给用户后自动删除服务器上的临时ZIP文件
            return Response::download($zipFilePath)->deleteFileAfterSend(true);

        } catch (\Exception $e) {
            // 捕获异常，确保ZIP文件在出错时也能被关闭（如果已打开）
            if (isset($zip) && $zip->status !== ZipArchive::ER_NOZIP) {
                $zip->close();
            }
            // 如果ZIP文件已创建但下载失败，尝试删除它
            if (file_exists($zipFilePath)) {
                unlink($zipFilePath);
            }
            Log::error("下载多文件时发生错误: " . $e->getMessage());
            return response()->json(['error' => '下载文件时发生错误: ' . $e->getMessage()], 500);
        }
    }
}