.zip、.rar、.7z、.tar.gz 等多种格式。这意味着我可能需要：启用 PHP 的 ZipArchive 扩展来处理 ZIP 文件，寻找一个 unrar 的系统命令来处理 RAR，再想办法应对 7z 和各种 TAR 格式。这不仅让代码变得臃肿复杂，还极度依赖服务器的环境配置——万一某个扩展没开，或者某个命令行工具没安装，我的程序就可能崩溃。每次部署到新环境，都像是在“开盲盒”，心里总是不踏实。我尝试过各种办法，比如用 shell_exec 调用系统命令，但安全性、性能和跨平台兼容性都成了问题。我也研究过一些纯 PHP 的解压库，但它们往往只支持少数几种格式，或者在处理大型文件时表现不佳。正当我为此焦头烂额时，我发现了 wapmorgan/unified-archive 这个宝藏库，它以一种优雅且统一的方式解决了所有这些难题。
Composer在线学习地址：学习地址
UnifiedArchive：压缩文件处理的“万能钥匙”
wapmorgan/unified-archive 的核心理念是提供一个统一的接口来处理所有流行的压缩文件格式。无论底层是 PHP 扩展、系统命令行工具，还是纯 PHP 实现，你都只需要一套代码来与之交互。它会自动检测文件格式，并智能地选择最佳的可用“驱动”来完成任务。这意味着你的代码将变得更加简洁、健壮，并且具有极高的可移植性。
它支持的格式非常广泛，包括但不限于：zip、7z、rar、gz、bz2、xz、cab、tar、tar.gz、tar.bz2、tar.x、tar.Z 等。更棒的是，它不仅能解压，还能创建新的压缩包、列出文件内容、提取特定文件、甚至支持带密码的压缩包操作！
如何使用 UnifiedArchive？
1. 安装
使用 Composer 安装 wapmorgan/unified-archive 非常简单：
composer require wapmorgan/unified-archive
安装完成后，你甚至可以使用它自带的命令行工具 cam 来检查当前系统支持的格式和驱动：
./vendor/bin/cam system:formats ./vendor/bin/cam system:format zip
2. 基本用法：解压与创建
下面通过几个简单的例子，看看 UnifiedArchive 是如何让压缩文件操作变得如此轻松的：
解压文件：
假设你有一个名为 archive.zip 的压缩包，想把它解压到 /var/www/extracted 目录下：
use \wapmorgan\UnifiedArchive\UnifiedArchive;
$output_dir = '/var/www/extracted';
$archive_path = 'archive.zip'; // 也可以是 archive.rar, archive.tar.bz2 等
try {
// 自动检测格式并打开压缩包
$archive = UnifiedArchive::open($archive_path);
// 检查目标目录是否有足够的空间（可选但推荐）
if (disk_free_space($output_dir) < $archive->getOriginalSize()) {
throw new \RuntimeException('空间不足！需要 ' . ($archive->getOriginalSize() - disk_free_space($output_dir)) . ' 字节。');
}
// 执行解压操作
$extracted_files_count = $archive->extract($output_dir);
echo '成功解压了 ' . $extracted_files_count . ' 个文件！' . PHP_EOL;
} catch (\Exception $e) {
echo '解压失败：' . $e->getMessage() . PHP_EOL;
}创建压缩包：
如果你想把一些文件和目录打包成一个新的 archive.zip：
use \wapmorgan\UnifiedArchive\UnifiedArchive;
$files_to_archive = [
'README.md' => '/path/to/your/README.md', // 压缩包内文件名 => 源文件路径
'docs' => '/path/to/your/documentation/', // 压缩包内目录名 => 源目录路径
'images/logo.png' => '/path/to/your/assets/logo.png',
];
$new_archive_path = 'new_archive.zip';
try {
// 创建新的 ZIP 压缩包，可以指定压缩级别等选项
UnifiedArchive::create($files_to_archive, $new_archive_path, [
'compression' => 'maximum' // 可选：'none', 'fast', 'normal', 'maximum'
]);
echo '成功创建了新的压缩包：' . $new_archive_path . PHP_EOL;
} catch (\Exception $e) {
echo '创建压缩包失败：' . $e->getMessage() . PHP_EOL;
}3. 更多高级功能
UnifiedArchive 还提供了许多实用的高级功能：
-
列出文件：
$archive->getFiles()可以获取压缩包内所有文件的列表。 -
读取文件内容：
$archive->getFileContent('path/to/file.txt')可以直接读取压缩包内某个文件的内容。 - 密码支持： 可以打开带密码的 ZIP/RAR/7z 压缩包，也可以为新创建的压缩包设置密码。
- 调整压缩级别： 在创建 ZIP、GZIP、7z 压缩包时，可以灵活调整压缩级别。
-
内置命令行工具：
vendor/bin/cam不仅可以检查驱动，还能在命令行直接进行档案操作，非常方便调试和自动化脚本。
总结与实际应用效果
wapmorgan/unified-archive 彻底解决了我在处理多格式压缩文件时的痛点。它的统一接口让代码变得异常简洁，我不再需要为每种格式编写不同的逻辑。而其驱动机制（优先使用 PHP 扩展，其次是系统工具，最后是纯 PHP 方案）则确保了无论服务器环境如何，我的程序都能稳定运行，大大增强了可移植性和健壮性。
现在，我的 CMS 系统可以轻松应对用户上传的任何压缩包，无论是自动解压、内容扫描还是文件预览，都变得高效而可靠。对于任何需要在 PHP 应用中处理压缩文件的开发者来说，wapmorgan/unified-archive 绝对是一个值得你投入时间学习和使用的库。它将让你从繁琐的兼容性问题中解脱出来，专注于业务逻辑的实现！
