php 8 中用 ziparchive 压缩目录需递归遍历、路径处理与空目录支持，确保 zip 扩展启用；示例代码含错误检查、utf-8 文件名兼容方案及 phardata 替代方法。
PHP 8 中使用 ZipArchive 压缩目录文件，核心是递归遍历目录 + 正确处理路径 + 添加到 ZIP 包。只要确保 zip 扩展已启用（PHP 8 默认通常已开启），就能稳定运行。
✅ 确认 zip 扩展可用
运行以下代码检查：
<?php if (!extension_loaded('zip')) {
die('zip 扩展未启用，请在 php.ini 中启用 extension=zip');
}
echo "zip 扩展正常";
?>
如报错，需在 php.ini 中取消注释 extension=zip，然后重启 Web 服务或 PHP-FPM。
✅ 基础压缩目录的完整示例（含路径修复与空目录支持）
<?php function zipDirectory($source, $destination) {
if (!is_dir($source)) {
throw new Exception("源目录不存在: $source");
}
$zip = new ZipArchive();
$res = $zip->open($destination, ZipArchive::CREATE);
if ($res !== TRUE) {
throw new Exception("无法创建 ZIP 文件: $res");
}
$iterator = new RecursiveIteratorIterator(
new RecursiveDirectoryIterator($source),
RecursiveIteratorIterator::LEAVES_ONLY
);
foreach ($iterator as $file) {
$filePath = $file->getPathname();
$relativePath = substr($filePath, strlen($source) + 1);
// 跳过自身（避免把 zip 包也塞进去）
if ($filePath === $destination) continue;
// 处理空目录：addEmptyDir 需要相对路径（不含尾部斜杠，但 ZipArchive 会自动识别）
if ($file->isDir()) {
$zip->addEmptyDir($relativePath);
continue;
}
// 普通文件：addFile 保持相对路径结构
$zip->addFile($filePath, $relativePath);
}
$zip->close();
echo "✅ 目录已压缩为: $destination\n";
echo "? 大小: " . filesize($destination) . " 字节\n";
}
// 使用示例
zipDirectory('/var/www/myapp', '/tmp/myapp.zip');
⚠️ 注意：
addEmptyDir()在 PHP 8.0+ 中完全支持；若用旧版 PHP，可改用addFromString($dirName . '/', '')模拟空目录。
✅ 常见问题应对
中文文件名乱码？
ZipArchive默认不支持 UTF-8 文件名（Windows 解压软件常见问题）。临时方案：用iconv('UTF-8', 'GB2312', $name)转换（仅限简体中文环境），或改用PharData（对 UTF-8 更友好）。大目录内存溢出？
避免一次性加载全部文件列表。上面示例已用RecursiveIteratorIterator流式遍历，内存占用低。如仍超限，可加gc_collect_cycles()或分批处理。权限被拒绝？
确保 PHP 进程对源目录有读取权限、对目标路径有写入权限。不要用root运行脚本，推荐设置www-data或nginx用户可写目标目录。-
想排除某些文件（如 .git、cache）？
在foreach循环中加判断：$basename = basename($filePath); if (in_array($basename, ['.', '..', '.git', 'node_modules', 'cache'])) continue;
✅ 替代方案：用 PharData 压缩为 .tar.gz（更兼容、天然支持 UTF-8）
$phar = new PharData('/tmp/myapp.tar');
$phar->buildFromDirectory('/var/www/myapp');
$phar->compress(Phar::GZ); // 生成 /tmp/myapp.tar.gz
unlink('/tmp/myapp.tar'); // 清理中间文件
适合需要跨平台解压、保留中文路径、或后续要部署为 PHP 应用包的场景。
不复杂但容易忽略细节。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
