直接放.tar.gz到vendor/会报ziparchive::extractto错误，因composer启用zip扩展后无条件调用该方法解压，而它不识别.tar.gz格式；正确做法是用path repository映射本地解压目录。
为什么直接放 .tar.gz 到 vendor/ 会报 ZipArchive::extractTo 错误
PHP 启用了 zip 扩展后，Composer 在校验、临时提取或 fallback 流程中会无条件调用 ZipArchive::extractTo() —— 它不识别 .tar.gz，也不区分你手动放的是什么文件。哪怕你删了 composer.lock、清空 vendor/，只要扩展开着，这个错误就大概率触发。
常见诱因包括：
-
php -m | grep zip返回非空，但系统没装tar命令或phar扩展，导致 tar 解压路径不可用 - 你把
.tar.gz放进vendor/，但composer.lock仍存在，composer install会按锁文件尝试远程拉取并解压 - 包的
composer.json里没声明"dist": {"type": "tar"}，Composer 不认为你放的 tar 是合法 dist 包
用 path repository 映射本地解压后的目录（推荐）
这是最干净、可复现、不绕过 Composer 核心逻辑的方式。关键不是“怎么塞进 vendor”，而是“让 Composer 把本地目录当包源”。
操作步骤：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 把下载好的
.tar.gz或.zip解压到任意本地路径，例如./packages/my-lib/ - 确保该目录下有完整、合法的
composer.json（至少含"name"和"autoload"字段） - 在项目根目录
composer.json的repositories数组里加一项：
{
"type": "path",
"url": "./packages/my-lib"
}
- 在
require中写明包名和版本，如"vendor/my-lib": "*"（注意 name 必须和本地包composer.json里完全一致） - 运行
composer update vendor/my-lib（不是install），它会复制或软链接过去
想用软链接而不是复制？检查这几个点
默认 path 类型是复制，改软链接需满足三个条件：
- 本地包的
composer.json里加"options": {"symlink": true} - 使用 Composer 2.2+（旧版本不支持）
- 必须执行
composer update vendor/my-lib，install不生效 - 执行后检查
ls -la vendor/vendor/my-lib是否指向源目录；如果不是，说明options没被读到，或者路径写错（url必须是相对路径，不能以../跨出项目根目录外）
别用 package repository 替代 path
有人试图在 repositories 里写 "type": "package"，手动定义 dist 地址和版本——这能绕过网络，但代价是：
- 每次改本地源码都得手动
composer update，不自动感知变更 - 不支持
autoload自动发现，得自己维护vendor/autoload.php - 不支持
scripts（如post-autoload-dump）等完整包生命周期钩子
除非你在做离线 CI 预置且确定代码永不改动，否则 path 是唯一合理选择。
真正容易被忽略的是：路径必须相对、name 必须严格一致、composer.json 必须存在且合法——这三个点漏一个，path 就静默失效，不会报错，只会继续走 Packagist。
