告别磁盘写入：使用ZipStream-PHP高效生成压缩文件

在处理大文件或大量数据时，直接将数据写入磁盘可能会导致性能瓶颈或磁盘空间不足的问题。为了避免这些问题，可以使用 ZipStream-PHP 库来流式生成 ZIP 文件并直接输出到客户端，而不需要将整个 ZIP 文件写入磁盘。ZipStream-PHP 是一个高效的 PHP 库，专门用于生成 ZIP 文件并直接流式传输到客户端。

1. 安装 ZipStream-PHP

首先，你需要通过 Composer 安装 ZipStream-PHP 库：

composer require maennchen/zipstream-php

2. 使用 ZipStream-PHP 生成 ZIP 文件

以下是一个简单的示例，展示如何使用 ZipStream-PHP 生成一个 ZIP 文件并将其直接发送到客户端：

require 'vendor/autoload.php';

use ZipStream\ZipStream;
use ZipStream\Option\Archive;

// 设置 HTTP 头，告诉浏览器这是一个 ZIP 文件
header('Content-Type: application/zip');
header('Content-Disposition: attachment; filename="example.zip"');

// 创建 ZipStream 对象
$options = new Archive();
$options->setSendHttpHeaders(true); // 自动发送 HTTP 头

$zip = new ZipStream('example.zip', $options);

// 添加文件到 ZIP
$zip->addFile('file1.txt', 'This is the content of file1.txt');
$zip->addFile('file2.txt', 'This is the content of file2.txt');

// 添加大文件（例如从数据库或外部 API 获取的数据）
$largeData = fopen('php://temp', 'r+');
fwrite($largeData, str_repeat('Large file content...', 100000));
rewind($largeData);
$zip->addFileFromStream('large_file.txt', $largeData);

// 完成 ZIP 文件的生成并发送到客户端
$zip->finish();

3. 代码解释

• HTTP 头设置: 通过 header() 函数设置 HTTP 头，告诉浏览器这是一个 ZIP 文件，并指定文件名。
• ZipStream 对象: 创建一个 ZipStream 对象，并设置选项（如自动发送 HTTP 头）。
• 添加文件: 使用 addFile() 方法将文件内容添加到 ZIP 文件中。你也可以使用 addFileFromStream() 方法从流中添加大文件。
• 完成 ZIP 文件: 调用 finish() 方法完成 ZIP 文件的生成并发送到客户端。

4. 优点

• 无需磁盘写入: 所有数据都是流式生成的，不会占用磁盘空间。
• 高效处理大文件: 即使是大文件或大量数据，也能高效处理。
• 即时下载: 客户端可以即时开始下载 ZIP 文件，而不需要等待整个文件生成完毕。

5. 注意事项

• 内存使用: 虽然 ZipStream-PHP 不会将整个 ZIP 文件写入磁盘，但如果处理的数据量非常大，仍然需要注意内存使用情况。
• 网络传输: 由于 ZIP 文件是流式生成的，网络传输的速度可能会影响客户端的下载体验。

通过使用 ZipStream-PHP，你可以高效地生成 ZIP 文件并直接发送到客户端，避免了磁盘写入的瓶颈，特别适合处理大文件或大量数据的场景。