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());
        }
    }
}