Composer如何处理tar包安装_Composer tar格式包加载方式【详解】-composer-PHP中文网

composer原生命令不支持自动识别本地.tar文件，必须通过artifact仓库或package类型仓库显式声明路径、命名和composer.json一致性才能加载。

composer如何处理tar包安装_composer tar格式包加载方式【详解】

Composer 原生命令不支持直接安装 .tar 包 —— 它只认 .zip、.tar.gz、.tgz、.tar.bz2 和 .tbz2，但前提是这些包被正确归类为「dist」或置于 artifact 仓库中；单独扔一个 mylib-1.0.0.tar 进目录，不改配置，composer install 会完全无视它。

为什么 `composer install` 不读本地 `.tar` 文件

Composer 的安装流程默认只从远程仓库（如 packagist.org）或已声明的本地仓库拉取包，它不会扫描任意目录下的 tar 文件。即使你手动放了一个 vendor/name-1.0.0.tar 在项目里，只要没在 repositories 中声明来源类型和路径，Composer 就当它不存在。

.tar 是被支持的 dist 格式之一，但必须通过 dist.url 或 artifact 仓库显式提供，不能“自动发现”
常见错误：把 myapp.tar 解压后复制进 vendor/ —— 这绕过了 Composer 的 autoload 注册、脚本执行、插件加载等关键环节，极易导致 Class not found 或 Script not executed
运行 composer show vendor/name 查不到包？说明它根本没被 Composer 索引到，不是路径或权限问题，而是仓库没配对

用 `artifact` 仓库加载本地 `.tar` 包的硬性条件

要让 Composer 正确识别并安装 .tar 包，必须满足三要素：命名规则、目录结构、仓库声明。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

文件名必须严格为 {vendor}/{package}-{version}.tar，例如 monolog/monolog-2.10.0.tar —— 缺少 vendor 子目录、版本号带 -beta 后缀、扩展名写成 .tar.gz 都会导致跳过
压缩包内根目录必须直接包含 composer.json，且其中 "name" 和 "version" 字段要与文件名完全一致（包括大小写）
repositories 中必须写成：
```
{"type": "artifact", "url": "/absolute/path/to/tar/directory"}
```
路径末尾不加斜杠，且该路径下不能混放其他非 tar 文件（否则索引变慢甚至失败）
必须禁用 packagist.org：
```
"packagist.org": false
```
放在 repositories 数组外层，否则同名包仍优先走线上源

`dist` 类型仓库 vs `artifact` 类型仓库：选哪个

两者都能加载 .tar，但适用场景完全不同。

artifact：适合离线分发，目录里放一堆包，Composer 自动扫描匹配所有 {vendor}/{pkg}-{ver}.tar；适合 CI 构建产物归档、内网部署
dist（package 类型）：适合单个包调试，需手动声明每个包的元信息，例如：
```
{"type": "package", "package": {"name": "myorg/mylib", "version": "1.0.0", "dist": {"url": "file:///tmp/mylib-1.0.0.tar", "type": "tar"}}}
```
注意 dist.url 必须是 file:// 协议绝对路径，且 dist.type 显式写 tar
别混淆 archive-format 配置项 —— 它对 composer archive 命令无效，原生命令只输出 .zip，这个配置只被第三方插件（如 composer-archiver）识别

验证 `.tar` 是否真被加载：看缓存和日志

光看 composer install 成功不等于 .tar 被用了。真正生效的信号藏在细节里。

执行 composer install -v，观察输出中是否出现 Downloading https://... -> /tmp/xxx.tar 或 Extracting archive 行 —— 如果只有 Installing monolog/monolog (2.10.0) 没有提取提示，说明它可能从缓存或 packagist 回退下载了
检查 vendor/composer/installed.json，找到对应包的 dist 字段，确认 type 是 tar，url 指向你的本地路径
删掉 vendor/ 和 composer.lock，再跑 composer install --no-cache —— 避免旧缓存干扰判断
如果报错 Could not parse version constraint 或 Package not found，大概率是 composer.json 里的 name 和文件名不一致，或路径权限不足（PHP 进程用户无法读取 tar 目录）