Laravel 5.4中如何上传文件并压缩为带密码的Zip包

嘿，这个需求其实不难实现！Laravel本身虽然没有直接提供加密压缩的API，但我们可以借助PHP的zip扩展或者封装好的第三方包来搞定。我给你两种可行的方案，你可以根据自己的情况选择：

方案一：使用第三方封装包（推荐，更简洁） #

我推荐用chumper/zipper这个包，它封装了PHP的ZipArchive，用起来更顺手，不用写太多底层逻辑。

步骤1：安装依赖 #

首先在项目根目录运行Composer命令安装包：

composer require chumper/zipper

步骤2：修改上传逻辑 #

把你原来的上传代码替换成下面的逻辑，我已经加上了压缩和密码设置的部分：

use Chumper\Zipper\Zipper;
use Illuminate\Http\Request;

public function uploadAndEncrypt(Request $request)
{
    // 先验证上传文件的合法性
    $request->validate([
        'file' => 'required|file|max:2048', // 这里的max是2MB，你可以根据需求调整
    ]);

    // 获取上传的文件对象
    $uploadedFile = $request->file('file');
    // 提取原文件名（不含后缀）和后缀
    $originalFileName = pathinfo($uploadedFile->getClientOriginalName(), PATHINFO_FILENAME);
    $fileExtension = $uploadedFile->getClientOriginalExtension();
    // 定义最终生成的加密Zip文件名
    $zipFileName = "{$originalFileName}_protected.zip";
    // 定义Zip文件的存储路径（存在storage/app/protected_files目录下）
    $zipStorageDir = storage_path('app/protected_files');

    // 如果存储目录不存在，自动创建
    if (!file_exists($zipStorageDir)) {
        mkdir($zipStorageDir, 0755, true);
    }

    // 初始化Zipper实例
    $zipper = new Zipper;

    try {
        // 创建Zip包，添加上传的文件，设置密码后关闭
        $zipper->make("{$zipStorageDir}/{$zipFileName}")
            ->add($uploadedFile->getPathname(), "{$originalFileName}.{$fileExtension}")
            ->setPassword(env('ZIP_PROTECTION_PASSWORD')) // 建议把密码存在.env文件里，不要硬编码！
            ->close();

        // 可选：删除上传后的临时原文件，节省存储空间
        unlink($uploadedFile->getPathname());

        return response()->json([
            'success' => true,
            'message' => '文件已成功上传并加密压缩',
            'zip_file' => $zipFileName
        ]);
    } catch (\Exception $e) {
        // 捕获异常并返回错误信息
        return response()->json([
            'success' => false,
            'message' => "处理失败：{$e->getMessage()}"
        ], 500);
    }
}

方案二：使用原生PHP ZipArchive（无需额外包） #

如果你不想引入第三方包，直接用PHP自带的ZipArchive扩展也能实现，不过代码会稍微繁琐一点：

use Illuminate\Http\Request;

public function uploadAndEncrypt(Request $request)
{
    $request->validate([
        'file' => 'required|file|max:2048',
    ]);

    $uploadedFile = $request->file('file');
    $originalFileName = pathinfo($uploadedFile->getClientOriginalName(), PATHINFO_FILENAME);
    $fileExtension = $uploadedFile->getClientOriginalExtension();
    $zipFileName = "{$originalFileName}_protected.zip";
    $zipStorageDir = storage_path('app/protected_files');

    if (!file_exists($zipStorageDir)) {
        mkdir($zipStorageDir, 0755, true);
    }

    $zip = new \ZipArchive();
    $zipFullPath = "{$zipStorageDir}/{$zipFileName}";

    try {
        // 打开Zip文件，CREATE表示创建新文件，OVERWRITE表示覆盖已有文件
        if ($zip->open($zipFullPath, \ZipArchive::CREATE | \ZipArchive::OVERWRITE) !== true) {
            throw new \Exception('无法创建加密压缩包');
        }

        // 将上传的文件添加到Zip包中
        $zip->addFile($uploadedFile->getPathname(), "{$originalFileName}.{$fileExtension}");
        // 设置压缩包密码
        $zip->setPassword(env('ZIP_PROTECTION_PASSWORD'));
        // 对添加的文件启用AES-256加密（需要PHP 7.2+，且zip扩展支持AES）
        $zip->setEncryptionName("{$originalFileName}.{$fileExtension}", \ZipArchive::EM_AES_256);

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

        // 删除临时原文件
        unlink($uploadedFile->getPathname());

        return response()->json([
            'success' => true,
            'message' => '文件已成功上传并加密压缩',
            'zip_file' => $zipFileName
        ]);
    } catch (\Exception $e) {
        return response()->json([
            'success' => false,
            'message' => "处理失败：{$e->getMessage()}"
        ], 500);
    }
}

一些重要注意事项 #

• 确保你的PHP环境已经启用了zip扩展，可以通过php -m命令查看是否有zip这一项，如果没有需要先安装扩展。
• 绝对不要硬编码密码，把密码存在.env文件里，比如ZIP_PROTECTION_PASSWORD=your_strong_password，然后用env()函数读取。
• 如果用原生ZipArchive的AES加密，需要PHP 7.2及以上版本，且zip扩展支持AES加密（部分环境可能需要重新编译zip扩展开启此功能）。
• 存储目录要设置正确的权限，确保Laravel有读写权限，避免出现无法创建文件的错误。
• 记得处理异常情况，比如文件上传失败、Zip创建失败等，给用户友好的错误提示。

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