ZipArchive可用时可实现文件压缩与解压，通过open、addFile、extractTo和close方法完成操作，支持目录递归压缩及指定路径解压，需注意权限、编码与执行时间限制。
在PHP开发中，处理文件压缩与解压是常见需求，比如生成备份、打包用户上传文件或解压第三方数据包。PHP内置的 ZipArchive 类提供了完整的 ZIP 文件操作能力，无需依赖外部命令或扩展（只要启用了 zip 模块）。下面详细介绍如何使用 PHP 调用文件压缩与解压功能。
启用 ZipArchive 扩展
确保你的 PHP 环境支持 ZipArchive。大多数现代 PHP 版本默认已启用，可通过以下代码检查：
if (class_exists('ZipArchive')) {
echo "ZipArchive 可用";
} else {
echo "ZipArchive 不可用，请检查 php_zip.dll (Windows) 或安装 zip 扩展 (Linux)";
}
Linux 用户若未启用，可使用包管理器安装：
# Ubuntu/Debian sudo apt-get install php-zipCentOS/RHEL
sudo yum install php-pecl-zip
使用 ZipArchive 压缩文件
将一个或多个文件打包成 ZIP 压缩包，步骤如下：
- 创建 ZipArchive 实例
- 打开目标 ZIP 文件（不存在则创建）
- 添加文件或目录内容
- 关闭归档
示例：压缩单个文件
$zip = new ZipArchive(); $filename = 'backup.zip';if ($zip->open($filename, ZipArchive::CREATE) === TRUE) { $zip->addFile('data.txt', 'data.txt'); // 源文件, 在压缩包中的名称 $zip->close(); echo "压缩完成: $filename"; } else { echo "无法创建压缩包"; }
示例：递归压缩整个目录
function addFolderToZip($dir, $zip) {
$files = scandir($dir);
foreach ($files as $file) {
if ($file == '.' || $file == '..') continue;
$path = "$dir/$file";
if (is_dir($path)) {
$zip->addEmptyDir($file);
addFolderToZip($path, $zip);
} else {
$zip->addFile($path, $file);
}
}
}
$zip = new ZipArchive();
if ($zip->open('project.zip', ZipArchive::CREATE) === TRUE) {
addFolderToZip('src', $zip);
$zip->close();
echo "目录压缩成功";
}
使用 ZipArchive 解压文件
解压 ZIP 包到指定目录非常简单：
- 打开 ZIP 文件
- 调用 extractTo 方法指定解压路径
- 关闭归档
示例：解压到当前目录下的 extracted/
$zip = new ZipArchive(); $filename = 'backup.zip';if ($zip->open($filename) === TRUE) { $zip->extractTo('./extracted'); $zip->close(); echo "解压完成"; } else { echo "无法打开压缩包"; }
你也可以只解压部分文件：
// 只解压 data.txt 和 config.json
$zip->extractTo('./extr
acted', ['data.txt', 'config.json']);
acted', ['data.txt', 'config.json']);
常见问题与注意事项
实际使用中需注意以下几点：
- 确保运行 PHP 的用户对目标目录有读写权限
- 大文件压缩建议设置执行时间限制：set_time_limit(300)
- 中文文件名可能出现乱码，尽量使用 UTF-8 编码，部分旧系统 ZIP 工具不兼容
- addFile() 第二个参数决定压缩包内路径，可用于重命名或组织结构
- 使用 addFromString() 可直接从字符串创建文件，适合动态内容
示例：从字符串生成日志并加入压缩包
$logContent = "User exported data at " . date('Y-m-d H:i:s');
$zip->addFromString('export_log.txt', $logContent);
基本上就这些。掌握 ZipArchive 的基本用法后，你可以轻松实现自动备份、项目打包、用户资源下载等功能。核心是理解 open、addFile、extractTo 和 close 这几个关键方法的组合使用。
