PHP使用zip_*函数读取和解析ZIP压缩包内容的完整示例

山海之间

发布时间：2026-10-14| 5人浏览过

原创

本文详解PHP内置的`zip_*`系列函数在ZIP文件处理中的应用，提供遍历压缩包元数据并读取文件内容的标准操作代码。

PHP实现原理与目标

PHP环境通常自带Zip扩展，无需额外安装即可处理ZIP格式文件。本文旨在通过经典的zip_*()函数族实现以下目标：

遍历检查：打开ZIP包并逐个获取内部条目（Entry）的信息。
属性获取：读取文件名、真实大小、压缩后大小及算法类型。
内容读取：以只读模式打开具体条目并输出其文本内容。

准备条件与环境

在执行脚本前，请确保：

服务器启用了 php_zip 扩展（通常在php.ini中通过 extension=zip 开启）。
本地存在一个名为 111.zip 的测试压缩包，该文件位于脚本同级目录或可访问的路径下。

操作步骤与代码解析

第1步：初始化ZIP文件句柄

目的：建立与物理ZIP文件的连接。若失败则说明路径错误或文件不存在。

入口：使用 zip_open() 函数传入文件路径。

<?php
// 1. 尝试打开 ZIP 文件
$zip = zip_open("111.zip");
if (!$zip) {
    die("无法打开 ZIP 文件");
}
?

第2步：遍历ZIP内部结构

目的：获取压缩包内的所有文件条目信息。

动作：循环调用 zip_read() 直到返回 false（表示读完）。对每次获取到的 $zip_entry 进行元数据统计。

关键参数说明：

zip_entry_name(): 获取条目的原始名称。
zip_entry_filesize(): 获取解压缩后的文件大小。
zip_entry_compressedsize(): 获取在ZIP中的压缩后大小。
zip_entry_compressionmethod(): 获取使用的压缩算法（如DEFLATE等）。

第3步：提取并读取文件内容

目的：将ZIP包内的实际文件内容还原为字符串。

动作：使用 zip_entry_open() 打开当前条目，指定模式为 "r"（只读）。调用 zip_entry_read() 读取全部字节，随后必须调用 zip_entry_close() 释放资源。

完成状态判断：控制台上打印出预期的文件文本流。

完整代码实现

以下是整合上述逻辑的标准写法，可直接复制运行验证：

<?php
$zip = zip_open("111.zip");
if ($zip) {
    while ($zip_entry = zip_read($zip)) {
        // 1. 打印条目基础属性
        echo "Name: " . zip_entry_name($zip_entry) . "\n";
        echo "Actual Filesize: " . zip_entry_filesize($zip_entry) . "\n";
        echo "Compressed Size: " . zip_entry_compressedsize($zip_entry) . "\n";
        echo "Compression Method: " . zip_entry_compressionmethod($zip_entry) . "\n";

        // 2. 只有当条目是常规文件（非目录）时才尝试读取内容
        if (zip_entry_open($zip, $zip_entry, "r")) {
            echo "File Contents:\n";
            // 读取该条目对应的大小，避免溢出
            $buf = zip_entry_read($zip_entry, zip_entry_filesize($zip_entry));
            echo "$buf\n";
            // 关闭当前条目引用，防止内存泄漏
            zip_entry_close($zip_entry);
        }
        echo "\n------------------\n"; // 分隔各文件信息
    }
    // 3. 最后关闭整个ZIP句柄
    zip_close($zip);
}
?>

效果验证

执行上述脚本后，控制台应当依次输出压缩包内各个文件的元数据以及对应的文本正文内容。下图展示了脚本运行的典型输出结果：

排错与建议

如果在开发过程中遇到问题，请参考以下几点进行排查：

Extension Error：如果报错“Call to undefined function zip_open”，请先确认 php.ini 中的 extension=zip 已生效且服务已重启。
Resource Limit：zip_entry_open 可能会受限于内存，处理超大单文件时建议分批读取或使用专门的解析库。
现代替代方案：对于更复杂的ZIP操作（如创建、加密），推荐优先使用面向对象风格的 ZipArchive 类，API更加规范易用。