Laravel 中创建 Zip 压缩文件并提供下载的实现方法

1. 概述

在 Laravel 中，我们经常需要处理文件的压缩和下载任务。其中，创建 Zip 压缩文件并提供下载是一个常见的需求。本文将介绍如何在 Laravel 中实现这一功能，并提供详细的步骤和代码示例。

2. 安装 Zip 扩展

在开始之前，我们需要确保服务器上已安装 Zip 扩展。在 Ubuntu 系统上，可以使用以下命令安装：

sudo apt-get install php-zip

安装完成后，需要重启 Web 服务器使扩展生效。

3. 创建 Zip 压缩文件

要在 Laravel 中创建 Zip 压缩文件，我们可以使用 PHP 的 ZipArchive 类。下面是一个简单的示例：

use ZipArchive;
public function createZip()
{
    $zip = new ZipArchive();
    $zipFileName = 'example.zip';
    if ($zip->open($zipFileName, ZipArchive::CREATE) !== true) {
        return "无法创建 Zip 文件";
    }
    // 添加文件到 Zip 压缩包
    $zip->addFile('/path/to/file1.txt', 'file1.txt');
    $zip->addFile('/path/to/file2.txt', 'file2.txt');
    
    // 添加目录到 Zip 压缩包
    $zip->addEmptyDir('images');
    $zip->addFile('/path/to/image1.jpg', 'images/image1.jpg');
    
    $zip->close();
    return "Zip 文件创建成功";
}

上述代码创建了一个名为 `example.zip` 的 Zip 压缩文件，并向其中添加了两个文本文件和一个图片文件。你可以根据实际需求添加更多的文件和目录。

4. 提供下载

创建 Zip 压缩文件后，我们需要提供一个下载链接供用户下载。在 Laravel 中，可以使用以下方式提供文件下载：

4.1 直接下载

如果要在同一请求中直接下载 Zip 文件，可以使用 Laravel 的 `response()` 函数：

use Illuminate\Support\Facades\Response;
use Illuminate\Support\Facades\Storage;
public function downloadZip()
{
    $zipFileName = 'example.zip';
    if (!Storage::disk('local')->exists($zipFileName)) {
        return "文件不存在";
    }
    return response()->download(storage_path('app/' . $zipFileName));
}

上述代码中，我们首先检查文件是否存在，然后使用 `response()->download()` 函数将文件提供给用户下载。

4.2 预览并下载

如果想提供一个下载链接，同时在用户点击下载前先预览 Zip 文件的内容，可以使用以下方式：

use Illuminate\Support\Facades\URL;
public function previewZip()
{
    $zipFileName = 'example.zip';
    if (!Storage::disk('local')->exists($zipFileName)) {
        return "文件不存在";
    }
    $zipFilePath = storage_path('app/' . $zipFileName);
    $temporaryUrl = URL::temporarySignedRoute(
        'download',
        now()->addMinutes(5),
        ['path' => $zipFilePath]
    );
    return "预览链接: " . $temporaryUrl;
}
public function downloadZip($path)
{
    return response()->download($path);
}

上述代码中，我们利用 Laravel 的 URL 生成了一个预览链接，并生成了一个路由 `download` 用于下载 Zip 文件，其中的 `$path` 参数表示文件的路径。

5. 结语

通过以上步骤，我们可以在 Laravel 中轻松地创建 Zip 压缩文件并提供下载。首先，我们需要确保服务器上安装了 Zip 扩展，然后使用 ZipArchive 类创建 Zip 文件并添加需要压缩的文件和目录。最后，我们可以提供直接下载或预览后下载的方式供用户下载。

这些技巧有助于 Laravel 开发人员在处理文件压缩和下载任务时更加高效和方便。