需先验证archive.tar.gz为标准tar.gz格式，即file命令输出同时含“gzip compressed data”和“POSIX tar archive”；再分两步解压：先用gzopen流式解压为archive.tar，再用PharData提取；或直接调用shell_exec('tar -xzf archive.tar.gz -C output/')。
需要从archive.tar.gz文件中准确提取出原始tar包内容，而不是把整个gz文件当普通压缩包处理——直接用ZipArchive类会报错，因为gzip和tar是两层独立封装。
确认文件实际格式
先用file命令验证文件真实类型：file archive.tar.gz。
输出必须包含“gzip compressed data”和“POSIX tar archive”两段描述，缺一则说明不是标准tar.gz；若只显示“gzip”，说明内部可能不是tar结构，后续解包会失败。
分步解压：先解gz，再解tar
第一步：用gzopen读取并解压到临时文件
使用gzopen('archive.tar.gz', 'rb')打开，配合gzread逐块读取，写入新文件archive.tar；不能用file_get_contents直接加载，【内存会爆】，尤其文件大于100MB时。
立即学习“PHP免费学习笔记（深入）”；
第二步：用PharData解析tar包
实例化$phar = new PharData('archive.tar'); 然后调用$phar->extractTo('output/')即可展开全部内容。
注意：PharData默认不支持.gz后缀的直接加载，必须先剥离gzip层——这是最常卡住的地方。
一行命令替代方案（Linux/macOS环境）
方法一：shell_exec('tar -xzf archive.tar.gz -C output/')
这行代码在PHP中执行最快，但需确保系统已安装tar且web用户有执行权限。
方法二：proc_open管道流式解压
用proc_open启动tar -xzf - -C output/，然后把file_get_contents('archive.tar.gz')结果写入stdin；比方法一更安全，避免路径注入，但代码量翻倍。
