Laravel 多文件下载教程：使用 ZipArchive 打包并提供下载

use Illuminate\Http\Request;

use Illuminate\Support\Facades\DB;

use Illuminate\Support\Str; // 导入 Str 类用于生成唯一文件名

// ... 其他代码 ...

public function create(Request $request)

{

    // 确保 attachment_name 是一个文件数组

    if ($request->hasFile(attachment_name)) {

        $datatest = [];

        foreach ($request->file(attachment_name) as $file) {

            // 生成唯一文件名，防止冲突

            $name = date(dmY) . "-" . Str::random(10) . "-" . $file->getClientOriginalName();

            // 将文件移动到公共存储路径

            $file->move(public_path(storage/file), $name);

            $datatest[] = $name;

        }

        // 将所有文件名用 "|" 拼接成字符串

        $insert[attachment_name] = implode("|", $datatest);

        // 将 $insert 数组插入数据库

        DB::table(media_order)->insert($insert);

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

    }

    return redirect()->back()->with(error, 未检测到文件上传。);

}

use Illuminate\Support\Facades\DB;

use Illuminate\Support\Facades\Response;

use ZipArchive; // 确保导入 ZipArchive 类

// ... 其他代码 ...

public function download($id)

{

    $row = DB::table(media_order)->where(id, $id)->first();

    if (!$row || empty($row->attachment_name)) {

        return redirect()->back()->with(error, 未找到相关文件或文件列表为空。);

    }

    $fileNames = explode("|", $row->attachment_name);

    $storagePath = public_path(storage/file) . DIRECTORY_SEPARATOR; // 文件实际存储路径

    $filesToZip = [];

    // 过滤掉不存在的文件，并构建完整路径

    foreach ($fileNames as $fileName) {

        $fullPath = $storagePath . $fileName;

        if (file_exists($fullPath)) {

            $filesToZip[] = $fullPath;

        }

    }

    if (empty($filesToZip)) {

        return redirect()->back()->with(error, 所有文件均不存在或已被删除。);

    }

    // ... 后续 ZIP 打包逻辑 ...

}

// ... 承接上文 ...

    $zip = new ZipArchive();

    $zipFileName = download_ . $id . _ . time() . .zip; // 生成唯一 ZIP 文件名

    $zipFilePath = public_path(storage/temp_zips) . DIRECTORY_SEPARATOR . $zipFileName; // 临时 ZIP 文件完整路径

    // 确保临时目录存在

    if (!file_exists(dirname($zipFilePath))) {

        mkdir(dirname($zipFilePath), 0777, true); // 递归创建目录，并设置权限

    }

    if ($zip->open($zipFilePath, ZipArchive::CREATE | ZipArchive::OVERWRITE) !== TRUE) {

        return redirect()->back()->with(error, 无法创建 ZIP 文件。);

    }

    // ... 添加文件到压缩包 ...

// ... 承接上文 ...

    foreach ($filesToZip as $fullPath) {

        // 获取文件名（在ZIP包内显示的文件名）

        $fileNameInZip = basename($fullPath);

        $zip->addFile($fullPath, $fileNameInZip);

    }

    // ... 完成压缩并响应下载 ...

// ... 承接上文 ...

    $zip->close(); // 关闭 ZIP 档案，完成写入

    // 检查 ZIP 文件是否成功创建

    if (!file_exists($zipFilePath)) {

        return redirect()->back()->with(error, ZIP 文件创建失败或不存在。);

    }

    // 准备下载响应

    return Response::download($zipFilePath)->deleteFileAfterSend(true); // 下载完成后删除临时文件

}

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

use Illuminate\Support\Facades\DB;

use Illuminate\Support\Facades\Response;

use ZipArchive;

use Exception;

class FileDownloadController extends Controller

{

    /**

     * 处理多文件下载请求，将文件打包成 ZIP 压缩包。

     *

     * @param int $id 数据库记录ID

     * @return \Symfony\Component\HttpFoundation\BinaryFileResponse|\Illuminate\Http\RedirectResponse

     */

    public function download($id)

    {

        try {

            $row = DB::table(media_order)->where(id, $id)->first();

            if (!$row || empty($row->attachment_name)) {

                return redirect()->back()->with(error, 未找到相关文件或文件列表为空。);

            }

            $fileNames = explode("|", $row->attachment_name);

            $storagePath = public_path(storage/file) . DIRECTORY_SEPARATOR; // 文件实际存储路径

            $filesToZip = [];

            // 过滤掉不存在的文件，并构建完整路径

            foreach ($fileNames as $fileName) {

                $fullPath = $storagePath . $fileName;

                if (file_exists($fullPath)) {

                    $filesToZip[] = $fullPath;

                }

            }

            if (empty($filesToZip)) {

                return redirect()->back()->with(error, 所有文件均不存在或已被删除。);

            }

            $zip = new ZipArchive();

            // 生成唯一 ZIP 文件名，例如：download_123_1678901234.zip

            $zipFileName = download_ . $id . _ . time() . .zip;

            // 定义临时 ZIP 文件的完整路径

            // 建议将临时 ZIP 文件放在一个非公共访问的目录，例如 storage_path(app/temp_zips)

            // 但为了与原问题上下文保持一致，此处仍使用 public_path(storage/temp_zips)

            $tempZipDirectory = public_path(storage/temp_zips);

            $zipFilePath = $tempZipDirectory . DIRECTORY_SEPARATOR . $zipFileName;

            // 确保临时目录存在且可写

            if (!file_exists($tempZipDirectory)) {

                // 0755 是一个常见的安全权限，如果遇到权限问题可尝试 0777

                mkdir($tempZipDirectory, 0755, true);

            }

            // 打开 ZIP 档案

            if ($zip->open($zipFilePath, ZipArchive::CREATE | ZipArchive::OVERWRITE) !== TRUE) {

                return redirect()->back()->with(error, 无法创建 ZIP 文件。请检查目录权限。);

            }

            // 将文件添加到 ZIP 档案

            foreach ($filesToZip as $fullPath) {

                // basename() 获取文件在 ZIP 包内显示的文件名

                $fileNameInZip = basename($fullPath);

                $zip->addFile($fullPath, $fileNameInZip);

            }

            $zip->close(); // 关闭 ZIP 档案，完成写入

            // 检查 ZIP 文件是否成功创建

            if (!file_exists($zipFilePath)) {

                return redirect()->back()->with(error, ZIP 文件创建失败或不存在。);

            }

            // 响应下载请求，并在发送后删除临时 ZIP 文件

            return Response::download($zipFilePath)->deleteFileAfterSend(true);

        } catch (Exception $e) {

            // 捕获所有可能的异常，提供友好的错误信息

            return redirect()->back()->with(error, 下载过程中发生错误： . $e->getMessage());

        }

    }

}