想象一下这样的场景：你正在开发一个 PHP 应用，其中一个核心功能是需要处理用户上传的 ZIP 文件，或者需要定期将网站数据打包成 TAR.GZ 格式进行备份。你可能自然而然地想到了 PHP 内置的 ZipArchive 类或者 PharData。它们确实强大，但在实际部署时，你可能会遇到一些令人头疼的问题：
-
扩展依赖的困境： 你的生产服务器可能出于安全或配置限制，并没有启用
zip或phar扩展。这时候，你的代码就寸步难行了。 - 内存消耗的挑战： 当你需要创建一个包含大量文件或超大文件的压缩包时，如果将整个档案内容都加载到内存中再写入，很容易导致内存溢出，尤其是在资源有限的共享主机环境下。
- 开发环境与生产环境的不一致： 本地开发一切顺利，但部署到线上就报错，排查起来费时费力。
这些问题不仅增加了开发和运维的负担，也限制了应用的部署灵活性。难道就没有一个纯 PHP 的、更“独立”的解决方案来优雅地处理这些压缩档案吗？
幸运的是，splitbrain/php-archive 这个库应运而生，它正是为了解决这些痛点而设计的。
引入 splitbrain/php-archive：你的档案处理利器
splitbrain/php-archive 是一个纯 PHP 实现的库，用于读写 TAR 和 ZIP 档案。它的最大亮点在于，无需依赖任何特殊的 PHP 扩展（当然，如果你需要进行 gz 或 bzip 压缩，相应的 PHP 扩展还是需要的，但对于档案的基本读写，它完全独立）。这意味着你的应用在任何 PHP 运行环境中都能正常处理压缩文件，大大提高了项目的可移植性。
立即学习“PHP免费学习笔记（深入）”；
如何安装？
作为现代 PHP 项目，我们当然会使用 Composer 来管理依赖。安装 splitbrain/php-archive 简单得不能再简单：
composer require splitbrain/php-archive
执行完这条命令，Composer 就会自动下载并安装好这个库。
splitbrain/php-archive 的实战应用
这个库提供了 Tar 和 Zip 两个核心类，它们的用法非常相似。下面我们通过几个例子来看看如何使用它。
1. 列出档案内容
假设你有一个 myfile.tgz 文件，想看看里面有什么：
<?php
require_once 'vendor/autoload.php';
use splitbrain\PHPArchive\Tar;
$tar = new Tar();
$tar->open('myfile.tgz');
$toc = $tar->contents(); // 返回 FileInfo 对象的数组
print_r($toc);
$tar->close(); // 记得关闭档案
?>contents() 方法会返回一个 FileInfo 对象的数组，每个对象都包含了档案中一个文件的详细信息，比如文件名、大小、权限等。
2. 解压档案
需要将一个压缩包解压到指定目录？同样轻而易举：
<?php
require_once 'vendor/autoload.php';
use splitbrain\PHPArchive\Tar;
$tar = new Tar();
$tar->open('myfile.tgz');
$tar->extract('/tmp/extracted_files'); // 解压到 /tmp/extracted_files 目录
$tar->close();
echo "档案已成功解压到 /tmp/extracted_files\n";
?>3. 创建新的档案（低内存占用模式）
这是 splitbrain/php-archive 的一个亮点。如果你要创建一个很大的档案，直接写入文件系统可以有效避免内存溢出：
<?php
require_once 'vendor/autoload.php';
use splitbrain\PHPArchive\Tar;
use splitbrain\PHPArchive\FileInfo; // 如果需要设置文件信息
$tar = new Tar();
$tar->create('my_new_archive.tar.gz'); // 直接创建到文件系统
// $tar->setCompression(9, Tar::COMPRESS_GZIP); // 如果需要GZIP压缩
// 添加一个文件
$tar->addFile(__FILE__, 'my_script.php'); // 源文件路径，档案内路径
// 添加字符串数据
$tar->addData('some_data.txt', '这是要写入档案的一些文本数据。');
// 添加带有特定权限的文件
$fileInfo = new FileInfo();
$fileInfo->setPerm(0644); // 设置文件权限
$tar->addData('protected_file.txt', '这个文件有特定的权限。', $fileInfo);
$tar->close();
echo "新的档案 my_new_archive.tar.gz 已创建。\n";
?>注意，Tar 和 Zip 在压缩方式上略有不同：Tar 是将整个档案作为一个整体进行压缩，而 Zip 则是对每个文件单独压缩。因此，在使用 Zip 类时，你可以在每次 addFile() 或 addData() 之前调用 setCompression() 来为单个文件设置压缩级别。
4. 创建新的档案（内存模式）
如果你需要将档案内容作为字符串获取，而不是直接写入文件，可以使用内存模式：
<?php
require_once 'vendor/autoload.php';
use splitbrain\PHPArchive\Tar;
use splitbrain\PHPArchive\Archive; // 用于压缩常量
$tar = new Tar();
$tar->setCompression(9, Archive::COMPRESS_BZIP); // 设置BZIP2压缩
$tar->create(); // 在内存中创建
$tar->addData('hello.txt', 'Hello, world!');
$tar->addFile(__FILE__, 'self.php');
$archiveContent = $tar->getArchive(); // 获取压缩后的档案内容字符串
file_put_contents('memory_archive.tbz', $archiveContent); // 可以写入文件
$tar->close(); // 记得关闭档案
echo "内存档案 memory_archive.tbz 已创建并保存。\n";
?>为什么选择 splitbrain/php-archive？
- 极高的可移植性： 纯 PHP 实现意味着它几乎可以在任何 PHP 环境中运行，无需担心服务器是否安装了特定的扩展。这对于共享主机环境或对服务器配置有严格限制的场景尤其有用。
- 内存效率高： 在创建大型档案时，可以直接将内容写入文件系统，避免一次性加载所有数据到内存，有效防止内存溢出。
- API 简洁直观： 库的设计目标是保持简单，提供清晰的 API，让你能快速上手，轻松实现档案的读写操作。
-
解决依赖痛点： 彻底摆脱对
ZipArchive或PharData等特定扩展的强依赖，让你的应用更加健壮。 - 灵活性： 既支持直接操作文件系统，也支持在内存中构建档案内容，满足不同场景的需求。
当然，为了保持简单，splitbrain/php-archive 不支持修改现有档案（例如，添加或删除现有档案中的文件）。如果你需要更高级的档案修改功能，可能需要考虑其他解决方案或系统命令。但在大多数读写或新建档案的场景下，它已经足够强大。
总结
splitbrain/php-archive 是一个强大而实用的 PHP 库，它以纯 PHP 的方式解决了在各种环境下处理 ZIP 和 TAR 档案的难题。通过 Composer 轻松引入，其简洁的 API 和低内存占用的特性，让你的 PHP 应用在处理压缩文件时更加稳定、高效和灵活。无论是网站备份、数据导出，还是文件打包分发，它都能成为你工具箱中的一把利器。
如果你也曾为 PHP 扩展依赖或内存问题而烦恼，不妨尝试一下 splitbrain/php-archive，它或许能让你告别这些困扰，专注于核心业务逻辑的实现。
