PHP动态生成并下载包含数据库PDF文件的ZIP压缩包

心靈之曲

发布时间：2025-08-28 23:59:01

303人浏览过

来源于php中文网

原创

PHP动态生成并下载包含数据库PDF文件的ZIP压缩包

本文详细介绍了如何使用PHP的ZipArchive类，结合数据库操作，将存储在MySQL数据库中Base64编码的PDF文件动态打包成ZIP格式，并直接提供给用户下载。核心在于利用addFromString方法，避免在服务器上创建临时PDF文件，实现高效、无痕迹的文件打包与分发，同时涵盖了数据库交互、Base64解码、HTTP头设置及错误处理等关键技术点。

引言：动态打包与下载数据库PDF文件

在web开发中，经常会遇到需要将用户上传或系统生成的文档（如pdf）存储在数据库中，并在需要时提供打包下载的需求。尤其当这些文件以base64编码形式存储时，如何高效、安全地将其整合到zip压缩包中，并直接供用户下载，成为一个常见挑战。本教程将深入探讨如何利用php的ziparchive类，特别是其addfromstring方法，实现这一功能，从而避免在服务器上创建大量的临时文件，优化资源利用。

核心技术解析

实现动态打包下载功能主要依赖以下几个核心技术：

ZipArchive 类： PHP内置的用于创建、读取和修改ZIP文件的强大工具。
- open(string $filename, int $flags): 打开或创建一个ZIP文件。$flags 通常使用 ZipArchive::CREATE 来创建新文件。
- addFromString(string $localname, string $contents): 这是本方案的关键。它允许你直接从一个字符串（即文件的二进制内容）向ZIP文件中添加一个条目，而无需先将该内容写入磁盘上的一个临时文件。$localname 是ZIP文件内部的文件名，$contents 是文件的二进制数据。
- close(): 关闭ZIP文件句柄，完成所有写入操作。
PDO 数据库扩展： 用于安全、高效地与MySQL数据库进行交互。通过预处理语句（Prepared Statements）可以有效防止SQL注入攻击。
Base64 解码： 当文件内容以Base64编码存储在数据库中时，需要使用 base64_decode() 函数将其转换回原始的二进制格式。
HTTP 文件下载头： 为了指示浏览器下载文件而不是在浏览器中显示，需要设置特定的HTTP响应头。
- Content-Type: application/zip: 告诉浏览器响应内容是一个ZIP文件。
- Content-Disposition: attachment; filename="your_file_name.zip": 强制浏览器下载文件，并指定下载时的文件名。
- Content-Length: file_size_in_bytes: 告知浏览器文件的大小，有助于下载进度显示。
- flush() 和 readfile(): flush() 清空输出缓冲区，readfile() 直接将文件内容输出到浏览器。

实现步骤与示例代码

下面将通过一个具体的示例来展示如何将数据库中的多个Base64编码的PDF文件打包成一个ZIP文件并提供下载。

步骤一：初始化 ZipArchive 并打开 ZIP 文件

首先，我们需要创建一个ZipArchive实例，并指定将要生成的ZIP文件的路径和名称。

open($nomzip, ZipArchive::CREATE | ZipArchive::OVERWRITE) === TRUE) {
    // ZIP文件成功打开，继续下一步
    // ...
} else {
    // ZIP文件创建失败
    echo "Error - Zip file could not be created";
    exit; // 终止脚本执行
}
?>

说明： ZipArchive::CREATE 标志用于在文件不存在时创建它。ZipArchive::OVERWRITE 标志（可选）用于如果文件已存在则覆盖它。请确保 $nomzip 指定的路径是服务器上PHP进程有写入权限的目录。

立即学习“PHP免费学习笔记（深入）”；

步骤二：连接数据库并获取 PDF 数据

在ZIP文件成功打开后，我们需要连接到数据库，查询并获取Base64编码的PDF数据。

open($nomzip, ZipArchive::CREATE | ZipArchive::OVERWRITE) === TRUE) {
    try {
        // 连接到数据库
        // 假设 db 类是 PDO 的封装
        $db = new db('mysql:dbname=jotform; host=localhost', 'root', '');
        $db->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

        // 准备并执行查询语句
        // 此处查询 `dhl` 表中 `submission_id` 匹配的记录，获取 `label_envoi` 和 `label_retour` 字段
        $sql = "SELECT `label_envoi`, `label_retour` FROM `dhl` WHERE `submission_id` = :suivi";
        $query = $db->prepare($sql);
        $query->execute(array(':suivi' => $suivi));

        // ... (继续下一步)

    } catch (PDOException $e) {
        // 数据库操作异常处理
        echo 'Error connecting to database or executing query: ' . $e->getMessage();
        $zip->close(); // 确保关闭ZIP文件句柄
        unlink($nomzip); // 删除可能已创建的空ZIP文件
        exit;
    }
} else {
    // ... (ZIP文件创建失败处理)
}
?>

说明： 示例中使用了自定义的db类来封装PDO连接。请确保你的数据库连接信息正确，并且查询语句能够准确地检索到包含Base64编码PDF数据的字段。

Psky企业网站系统1.1.2

Psky企业网站是基于PHP+MYSQL开发的一款企业官网宣传网站，支持PC、wap浏览。主要功能包括导航管理、轮播新闻、单位动态、通知通报、单位简介、后台管理等。运行环境下载安装PHPStudy（小皮）即可。系统采用PHP语言（版本：7.3.4nts）和MYSQL（版本：5.7.26）数据库进行开发，安装PHPStudy（小皮）集成环境进行测试通过。安装步骤：1、导入SQL文件到PHPmyad

下载

步骤三：解码 Base64 数据并添加到 ZIP

遍历查询结果，对每个Base64编码的PDF数据进行解码，然后使用addFromString方法将其添加到ZIP文件中。

open($nomzip, ZipArchive::CREATE | ZipArchive::OVERWRITE) === TRUE) {
    try {
        // ... (数据库连接和查询)

        $fileCount = 1; // 用于生成唯一文件名
        foreach ($query as $row) {
            // 解码第一个PDF文件数据
            $decoded1 = base64_decode($row['label_envoi']);
            // 解码第二个PDF文件数据
            $decoded2 = base64_decode($row['label_retour']);

            // 将解码后的二进制数据添加到ZIP文件
            // 注意：如果数据库查询可能返回多行，或者 `label_envoi` 和 `label_retour` 字段可能包含多个文件，
            // 则需要确保添加到ZIP中的文件名是唯一的，以避免文件覆盖。
            // 示例中使用了硬编码的文件名 "label1.pdf" 和 "label2.pdf"，
            // 实际应用中可能需要根据数据库中的其他信息（如文件名、ID等）动态生成。
            $zip->addFromString("label_{$fileCount}_envoi.pdf", $decoded1);
            $zip->addFromString("label_{$fileCount}_retour.pdf", $decoded2);
            $fileCount++;
        }

        // ... (继续下一步)

    } catch (PDOException $e) {
        // ... (数据库操作异常处理)
    }
} else {
    // ... (ZIP文件创建失败处理)
}
?>

说明： 这里的关键是$zip->addFromString("filename.pdf", $decoded_data);。它直接将 $decoded_data（二进制PDF内容）作为名为 "filename.pdf" 的文件添加到ZIP包中。为了避免ZIP包内文件名冲突，我们引入了$fileCount来确保文件名的唯一性。

步骤四：关闭 ZIP 档案并设置下载头

所有文件添加完毕后，必须关闭ZipArchive句柄。然后，设置正确的HTTP响应头，以便浏览器能够正确识别并下载ZIP文件。

open($nomzip, ZipArchive::CREATE | ZipArchive::OVERWRITE) === TRUE) {
    try {
        // ... (数据库连接、查询和文件添加)

        $zip->close(); // 关闭ZIP文件，完成写入操作

        // 设置HTTP响应头，指示浏览器下载ZIP文件
        header('Content-Type: application/zip');
        header('Content-Disposition: attachment; filename="' . basename($nomzip) . '"');
        header('Content-Length: ' . filesize($nomzip)); // 必须在文件关闭后获取文件大小

        // 清空PHP的输出缓冲区，确保文件内容直接输出
        flush();
        // 读取并输出ZIP文件内容到浏览器
        readfile($nomzip);

        // 可选：下载完成后删除服务器上的临时ZIP文件
        // unlink($nomzip);

    } catch (PDOException $e) {
        // ... (数据库操作异常处理)
    }
} else {
    // ... (ZIP文件创建失败处理)
}
?>

说明：

$zip->close() 是至关重要的，它会完成ZIP文件的写入并使其最终可用。
filesize($nomzip) 必须在 $zip->close() 之后调用，以获取最终的ZIP文件大小。
unlink($nomzip) 可以在文件下载完成后删除服务器上的临时ZIP文件，进一步保持服务器整洁。

完整示例代码

将以上所有步骤整合，得到一个完整的PHP脚本：

open($nomzip, ZipArchive::CREATE | ZipArchive::OVERWRITE) === TRUE) {
    try {
        // 连接到数据库
        $db = new db('mysql:dbname=jotform; host=localhost', 'root', '');
        $db->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

        // 准备并执行查询，获取Base64编码的PDF数据
        $sql = "SELECT `label_envoi`, `label_retour` FROM `dhl` WHERE `submission_id` = :suivi";
        $query = $db->prepare($sql);
        $query->execute(array(':suivi' => $suivi));

        $fileIndex = 1; // 用于生成ZIP包内文件的唯一名称
        foreach ($query as $row) {
            // 解码Base64数据为二进制
            $decodedEnvoi = base64_decode($row['label_envoi']);
            $decodedRetour = base64_decode($row['label_retour']);

            // 使用 addFromString 将二进制数据添加到ZIP文件
            // 确保ZIP包内文件名是唯一的
            $zip->addFromString("label_envoi_{$fileIndex}.pdf", $decodedEnvoi);
            $zip->addFromString("label_retour_{$fileIndex}.pdf", $decodedRetour);
            $fileIndex++;
        }

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

        // 设置HTTP响应头，指示浏览器下载ZIP文件
        header('Content-Type: application/zip');
        header('Content-Disposition: attachment; filename="' . basename($nomzip) . '"');
        header('Content-Length: ' . filesize($nomzip)); // 必须在文件关闭后获取文件大小

        // 清空输出缓冲区并直接输出ZIP文件内容
        flush();
        readfile($nomzip);

        // 可选：下载完成后删除服务器上的临时ZIP文件
        // unlink($nomzip);

    } catch (PDOException $e) {
        // 数据库操作异常处理
        echo '数据库操作失败: ' . $e->getMessage();
        // 确保在异常情况下关闭并删除可能已创建的ZIP文件
        if ($zip->status !== ZIPARCHIVE::ER_OK) { // 检查ZIP是否已成功关闭
             $zip->close();
        }
        if (file_exists($nomzip)) {
            unlink($nomzip);
        }
    }
} else {
    // ZIP文件创建失败处理
    echo "错误：无法创建ZIP文件。";
}
?>

注意事项

错误处理： 务必对$zip->open()的返回值进行检查，并使用try-catch块来处理数据库操作可能抛出的PDOException。在错误发生时，应及时关闭ZipArchive句柄并清理可能生成的临时文件。
文件名唯一性： 如果你的数据库查询结果可能包含多行，或者单个字段中可能包含多个逻辑上的文件，那么在调用addFromString()时，必须确保为每个文件在ZIP包中指定一个唯一的名称，否则后面的文件会覆盖前面的同名文件。
服务器文件路径： 示例中的 $nomzip 使用了硬编码的Windows路径。在生产环境中，建议使用动态获取的临时目录，如 sys_get_temp_dir()，并确保PHP进程对该目录有写入权限。下载完成后，最好使用 unlink($nomzip) 删除服务器上的临时ZIP文件。
内存与性能： 对于非常大的PDF文件或大量PDF文件，base64_decode() 和 addFromString() 可能会消耗较多内存。如果遇到内存限制，可能需要调整PHP的memory_limit配置，或者考虑更高级的流式处理方案（如果ZipArchive支持）。
HTTP 头发送时机： 所有的header()函数调用必须在任何实际内容输出到浏览器之前执行。包括HTML、空格、echo语句等都会导致“Headers already sent”错误。
安全性： 使用PDO的预处理语句可以有效防止SQL注入。同时，对用户输入（如$_POST['suivi']）进行验证和过滤也是良好的安全实践。

总结

通过本教程，我们学习了如何利用PHP的ZipArchive类及其addFromString方法，高效地将数据库中Base64编码的PDF文件打包成ZIP格式并提供下载。这种方法避免了在服务器上创建临时PDF文件，减少了磁盘I/O和存储需求，是处理此类需求的一种优雅且专业的解决方案。正确地处理数据库交互、Base64解码、HTTP头设置以及错误处理是确保此功能稳定可靠的关键。

PHP怎样控制建表大小写_PHP大小写建表规则【规范】

如何批量下载 MySQL 中存储的 BLOB 图像（PHP 实现）

如何通过级联下拉框精准筛选多国同名州/省下的城市数据

如何批量下载 MySQL 中存储的 JPEG 图像（BLOB 类型）

PHP本地环境怎么导入SQL数据文件_PHP本地环境导SQL数据文件办法【导入】