PHP使用ZipArchive实现在线打包下载功能

顾言

发布时间：2026-10-13| 6人浏览过

原创

介绍如何通过PHP的ZipArchive模块及特定头部信息设置，完成服务器端多文件的打包压缩并触发浏览器下载功能。

开启ZipArchive扩展

要实现ZIP文件压缩功能，首先需确保服务器已启用ZipArchive扩展。在Windows环境下通常涉及取消php_zip.dll相关配置；Linux系统则需确认zlib库状态。配置完成后重启Web服务（如IIS或Apache）使更改生效。

PHP配置图

如果不确定ini文件的具体路径，可以通过编写简单的info.php并在浏览器中访问来查看Loaded Configuration File项，确保定位到正确的配置文件进行修改。

核心代码逻辑

实现打包下载主要涉及三个环节：创建压缩包实例、遍历文件添加进包、设置Header头触发下载。以下是包含注释的核心代码片段：

open($filename.".zip", ZipArchive::OVERWRITE) !== TRUE) {
    exit("无法创建Zip文件");
}

// $data为包含文件信息的数组集合
foreach( $data as $val){
   // 拼接完整绝对路径
   $attachfile = "E:\\bysj\\bysj".$val['fileaddr'].$val['filename']; 
   
   // 【关键点】中文路径或文件名在Windows下通常需要编码转换，否则可能出现乱码或读取失败
   $attachfile = iconv("UTF-8","GBK",$attachfile); 
   
   // 将文件添加到压缩包
   // basename($attachfile) 决定了压缩包内文件的名称
   $zip->addFile($attachfile, basename($attachfile)); 
}

$zip->close(); // 关闭压缩资源

// --- 以下为核心：触发浏览器下载 ---
header("Content-type:text/html;charset=utf-8");
header("Cache-Control: public");
header("Content-Description: File Transfer");
// Content-Disposition中的文件名即为用户下载看到的默认文件名
header('Content-disposition: attachment; filename='.basename($filename).'.zip'); 
header("Content-Type: application/zip");
header("Content-Transfer-Encoding: binary");
header('Content-Length: '. filesize($filename.".zip"));

// 读取并输出文件内容至浏览器
@readfile($filename.".zip");

// 清理临时生成的zip文件(可选)
unlink($filename.".zip");
?>

注意事项

中文编码问题： 在不同操作系统和PHP版本中，文件路径编码可能不一致。若出现Warning: ZipArchive::addFile()找不到文件或报错，重点排查路径是否需要进行iconv或mb_convert_encoding转换。
文件路径安全： 代码示例中使用了硬编码路径，在生产环境中建议使用相对路径或环境变量管理文件位置，避免路径泄露带来的安全风险。
Header设置顺序： header()函数必须在任何HTML输出之前调用，否则会提示"Headers already sent"错误，导致下载失败。

以上就是PHP使用ZipArchive实现在线打包下载功能的详细内容，更多关于PHP文件打包操作的资料请关注本站其它相关文章！