Composer不支持Zstd/LZ4，因其ArchiverInterface仅依赖PHP内置扩展（zip、zlib等），而Zstd/LZ4需第三方扩展且未集成；接入需自定义Installer接管解压流程，并同步更新composer.lock以确保校验一致。
Composer 本身不支持 Zstd 或 LZ4 压缩算法，它只内置 tar、zip 和（通过 compress.zlib 封装协议）gzip。想在 Composer 生态中用 Zstd/LZ4，必须绕过默认归档逻辑，自己封装传输层——不是改 Composer，而是把它当“包元数据分发器”，把实际文件传输和解压交给自定义逻辑。
为什么 Composer 不支持 Zstd/LZ4？
Composer 的归档能力集中在 ArchiverInterface 及其实现类（如 ZipArchiver、TarArchiver），它们依赖 PHP 标准扩展（zip、phar、zlib）。而 Zstd/LZ4 需要 zstd 或 lz4 扩展，PHP 官方尚未将其纳入核心，Composer 也未在 src/Composer/Package/Archiver/ 中提供对应实现。
更关键的是：Composer 的下载流程（HttpDownloader → CurlDownloader）只做 HTTP GET + 文件落地，不介入解压环节；解压由安装器（LibraryInstaller 等）调用 Archiver 完成——这个链路是封闭的，无法注入第三方压缩逻辑。
如何在 Composer 流程中接入 Zstd/LZ4？
可行路径只有一条：**跳过 Composer 默认解压，接管 download 后的文件处理**。具体做法：
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 配置私有仓库返回的包为
.tar.zst或.tar.lz4文件（而非默认.tar或.zip） - 编写自定义
Installer类，继承LibraryInstaller，重写installCode方法 - 在该方法中，用
ext-zstd或ext-lz4扩展解压，再手动提取到$targetDir - 确保
composer.json中声明"require": {"php": ">=8.1", "zstd": "^0.5"}（或对应 LZ4 扩展）
示例关键代码片段：
// 自定义 Installer
public function installCode(PackageInterface $package, string $targetDir): void
{
$archive = $this->getInstallPath($package) . '.tar.zst';
$tmpDir = sys_get_temp_dir() . '/zstd-' . uniqid();
// 使用 ext-zstd 解压
$zstd = new \Zstd\Decoder();
file_put_contents($tmpDir . '/archive.tar', $zstd->decode(file_get_contents($archive)));
// 再用 tar 解包（PHP 8.2+ 支持 phar:tar://）
$phar = new \PharData($tmpDir . '/archive.tar');
$phar->extractTo($targetDir, null, true);
}
容易踩的坑：协议、权限与一致性
直接替换压缩格式会触发多个隐性问题：
-
compress.zstd不是 PHP 内置流封装协议，file://或http://URL 无法直接用stream_wrapper_register()注册后让 Composer 自动识别——必须显式调用解压函数 - Hyperf/Swoole 环境下，
exec('zstd -d')这类 shell 调用会破坏协程，必须用纯 PHP 扩展（ext-zstd）或Swoole\Process隔离 -
composer.lock里记录的是归档 URL 和 SHA256，换 Zstd 后哈希值完全不同，需同步更新 lock 文件，否则composer install会校验失败 - 私有仓库需明确返回
Content-Encoding: zstd头，但 Composer 的CurlDownloader不解析该头——你得在自定义 downloader 中手动检查并触发解码
真正难的不是解压本身，而是让整个 Composer 生命周期（解析 → 下载 → 校验 → 解压 → autoload 生成）不感知压缩算法变更。这要求你对 Composer\Installer、Composer\Package、Composer\Downloader 三层耦合点都做侵入式改造——Zstd/LZ4 的价值，只在带宽受限且 CPU 充足的边缘节点或 Serverless 场景下才盖过维护成本。
