
在web开发中,经常会遇到需要将用户上传或系统生成的文档(如pdf)存储在数据库中,并在需要时提供打包下载的需求。尤其当这些文件以base64编码形式存储时,如何高效、安全地将其整合到zip压缩包中,并直接供用户下载,成为一个常见挑战。本教程将深入探讨如何利用php的ziparchive类,特别是其addfromstring方法,实现这一功能,从而避免在服务器上创建大量的临时文件,优化资源利用。
实现动态打包下载功能主要依赖以下几个核心技术:
下面将通过一个具体的示例来展示如何将数据库中的多个Base64编码的PDF文件打包成一个ZIP文件并提供下载。
首先,我们需要创建一个ZipArchive实例,并指定将要生成的ZIP文件的路径和名称。
<?php
// 引入数据库连接类或其他必要的配置
include '../include/classe_PDO.php';
// 获取POST请求参数,例如一个ID用于查询相关PDF文件
$suivi = $_POST['suivi'];
// 定义ZIP文件的名称和存储路径。
// 注意:此路径应是服务器可写且可访问的临时路径。
// 在生产环境中,建议使用系统临时目录或更安全的路径。
$dirzip = date('Ymd His') . "_andromeda";
$nomzip = "C:/wamp64/www/Dylan/SAV/final/include/$dirzip.zip"; // 示例路径,请根据实际情况修改
$zip = new ZipArchive;
// 尝试打开或创建ZIP文件
if ($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免费学习笔记(深入)”;
在ZIP文件成功打开后,我们需要连接到数据库,查询并获取Base64编码的PDF数据。
<?php
// ... (前置代码,包括 ZipArchive 初始化)
if ($zip->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数据的字段。
遍历查询结果,对每个Base64编码的PDF数据进行解码,然后使用addFromString方法将其添加到ZIP文件中。
<?php
// ... (前置代码,包括 ZipArchive 初始化和数据库连接)
if ($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来确保文件名的唯一性。
所有文件添加完毕后,必须关闭ZipArchive句柄。然后,设置正确的HTTP响应头,以便浏览器能够正确识别并下载ZIP文件。
<?php
// ... (前置代码,包括 ZipArchive 初始化、数据库操作和文件添加)
if ($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文件创建失败处理)
}
?>说明:
将以上所有步骤整合,得到一个完整的PHP脚本:
<?php
// 引入数据库连接类,假设它封装了PDO
include '../include/classe_PDO.php';
// 从POST请求获取用于查询的ID
$suivi = $_POST['suivi'];
// 定义ZIP文件的名称和存储路径
// 注意:此路径是临时的,文件在下载后可以被删除。
// 在生产环境中,建议使用更安全的临时目录路径,例如 sys_get_temp_dir()。
$dirzip = date('Ymd His') . "_andromeda";
$nomzip = "C:/wamp64/www/Dylan/SAV/final/include/$dirzip.zip"; // 请根据实际服务器环境修改此路径
$zip = new ZipArchive;
// 尝试打开或创建ZIP文件
if ($zip->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文件。";
}
?>通过本教程,我们学习了如何利用PHP的ZipArchive类及其addFromString方法,高效地将数据库中Base64编码的PDF文件打包成ZIP格式并提供下载。这种方法避免了在服务器上创建临时PDF文件,减少了磁盘I/O和存储需求,是处理此类需求的一种优雅且专业的解决方案。正确地处理数据库交互、Base64解码、HTTP头设置以及错误处理是确保此功能稳定可靠的关键。
以上就是PHP动态生成并下载包含数据库PDF文件的ZIP压缩包的详细内容,更多请关注php中文网其它相关文章!
PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号