PHP解压tar.gz需解析多级后缀：先用pathinfo和正则逆向匹配复合后缀，映射为archive/compression类型；再用PharData解压+解包，或系统命令、zlib_decode组合；最后注册自定义处理器统一调用。
要在PHP中正确识别并解压 tar.gz 这类复合后缀文件，不能只依赖单一扩展名判断，必须让程序能解析多级后缀结构、区分归档与压缩层，并调用对应解包逻辑。
识别复合后缀并拆分层级
第一步：用 pathinfo() 获取基础信息 → 用正则匹配末尾的复合后缀模式，优先捕获 .tar.gz、.tar.bz2、.tar.xz 等常见组合。
第二步：定义后缀映射表，把 tar.gz 映射为 ['archive' => 'tar', 'compression' => 'gz']，这样后续可分别处理归档解包和压缩解压。
第三步：对文件名做逆向扫描，避免误判如 backup.tar.gz.old 被截成 .old。从字符串末尾开始匹配，找到最长合法复合后缀即停。
立即学习“PHP免费学习笔记（深入）”；
这一步若跳过，直接用 substr($file, -7) 判断 .tar.gz，会漏掉 .tar.bz2 或错判 .log.gz 这类非归档压缩文件。
选择对应解包函数组合
方法一：用 PharData 类（推荐）
实例化 new PharData($file) → 调用 decompress() 解压压缩层（如 gz → tar）→ 再用 extractTo() 解开 tar 归档。
注意：PharData 对 .tar.gz 支持良好，但对 .zip.gz 会失败，【必须确保复合后缀在 PharData 支持列表内】。
方法二：手动分步调用系统命令（需启用 shell_exec）
执行 gunzip -c file.tar.gz | tar -xf - -C /target → 用 proc_open 捕获错误码，避免解压中断时静默失败。
方法三：用 zlib_decode() + PharData 组合
先用 zlib_decode(file_get_contents($file)) 解出原始 tar 流 → 将结果写入临时文件 → 再用 PharData 加载该临时 tar 文件并解包。
注册自定义后缀处理器
第一步：定义全局配置数组 $archiveHandlers，键为复合后缀字符串（如 'tar.gz'），值为回调函数。
第二步：编写回调函数，接收文件路径和目标目录参数 → 内部调用前述 PharData 或命令行逻辑 → 返回布尔值表示成败。
第三步：封装统一入口函数 extractArchive($file, $to) → 自动推导后缀 → 查找匹配的处理器 → 执行对应逻辑。
这一步不做，每次解压都要重复写判断和调用，维护成本高且易出错。
