如何使用PHP压缩文件？ZipArchive高级用法-php教程-PHP中文网

如何使用PHP压缩文件？ZipArchive高级用法

星夢妙者

发布： 2025-07-11 17:47:02

原创

1066人浏览过

如何使用php的ziparchive类实现文件和目录的压缩？1. 创建压缩包：使用ziparchive类并调用addfile方法添加文件，通过ziparchive::create参数创建新文件；2. 压缩整个目录：递归遍历目录并逐个添加文件，注意路径拼接及过滤规则；3. 设置密码与注释：通过系统命令实现加密，使用setarchivecomment方法添加注释；4. 动态生成zip并输出：利用临时文件保存zip内容，设置header后输出给浏览器并清理缓存。

如何使用PHP压缩文件？ZipArchive高级用法

PHP压缩文件其实挺常见，尤其是在做文件打包下载、备份或者上传多文件处理的时候。用得最多的就是ZipArchive这个类了，它功能全、使用也方便。不过很多人只会基本的打包，其实它还有一些高级用法，能让你的操作更灵活。

如何创建一个压缩包？

这是最基础的操作，但也有一些细节需要注意。

$zip = new ZipArchive();
$filename = "example.zip";

if ($zip->open($filename, ZipArchive::CREATE) === TRUE) {
    $zip->addFile("file1.txt", "newname.txt"); // 添加文件并指定在zip中的名称
    $zip->addFile("file2.txt");
    $zip->close();
}

登录后复制

ZipArchive::CREATE：如果文件不存在就创建。
第二个参数可以用来重命名文件在压缩包里的名字。
如果你添加的是目录，记得要用递归方式遍历目录添加所有文件。

怎么把整个目录打成zip？

有时候我们需要把一个完整的目录结构打包，这时候就需要自己写个小函数来递归处理。

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

PPT.CN,PPTCN,PPT.CN是什么,PPT.CN官网,PPT.CN如何使用

一键操作，智能生成专业级PPT

查看详情

function addDirToZip($dir, $zip, $basePath = '') {
    $files = scandir($dir);
    foreach ($files as $file) {
        if ($file == '.' || $file == '..') continue;
        $filePath = $dir . '/' . $file;
        $localPath = $basePath . '/' . $file;

        if (is_dir($filePath)) {
            addDirToZip($filePath, $zip, $localPath);
        } else {
            $zip->addFile($filePath, ltrim($localPath, '/'));
        }
    }
}

$zip = new ZipArchive();
$zip->open('backup.zip', ZipArchive::CREATE);
addDirToZip('my_folder', $zip);
$zip->close();

登录后复制

这里用了递归遍历目录。
注意路径拼接的问题，避免出现错误路径。
可以根据需要加上过滤规则，比如跳过.git或cache目录。

压缩时设置密码和注释

ZipArchive本身不支持加密（也就是带密码的压缩），但你可以通过执行系统命令调用外部工具，比如zip命令。

exec('zip -P mypassword secure.zip file1.txt file2.txt');

登录后复制

-P 参数后面跟的是密码。
你需要确保服务器上安装了zip命令，并且PHP有权限执行。
这种方法比较适合Linux环境。

至于注释，ZipArchive提供了方法：

$zip->setArchiveComment('这是一个带注释的压缩包');

登录后复制

注释内容会被写入zip元数据中。
查看注释可以用支持该功能的解压软件。

高级技巧：动态生成zip并输出给浏览器

有时候我们不想把zip保存到服务器上，而是直接让用户下载。

$zip = new ZipArchive();
$tmpFile = tempnam(sys_get_temp_dir(), 'zip');

if ($zip->open($tmpFile, ZipArchive::CREATE) === TRUE) {
    $zip->addFromString('hello.txt', 'This is a test file');
    $zip->close();

    header('Content-Type: application/zip');
    header('Content-Length: ' . filesize($tmpFile));
    header('Content-Disposition: attachment; filename="download.zip"');
    readfile($tmpFile);
    unlink($tmpFile); // 下载完删除临时文件
}

登录后复制