composer如何安装来自Zip包的依赖_composer使用artifact仓库【方案】

composer不支持直接require本地zip包，须配置artifact仓库：将含合法composer.json的zip放入指定目录，composer.json中添加type为artifact的repositories配置，路径末尾需加斜杠，然后执行composer update。

直接用 composer require 安装本地 Zip 包行不通

Composer 默认不支持直接从本地 .zip 文件安装包，比如 composer require ./mylib.zip 会报错 Could not find a version of package ... matching your minimum-stability。这不是路径写错，而是 Composer 的依赖解析器根本不会把本地文件当仓库源处理。

真正可行的路只有一条：把 Zip 包当作 artifact 仓库 使用 —— 即让 Composer 把某个目录当成“存着一堆已打包好的 tar/zip 的静态文件仓库”，它会自动扫描、索引并按 name 和 version 解析。

• Zip 包必须包含合法的 composer.json（含 name、version、autoload 等必要字段）
• Zip 文件名无关紧要，但内容结构必须是「解压后根目录即为包源码」，不能套多一层文件夹
• 所有 Zip 包统一放在一个空目录下（如 ./artifacts/），不要嵌套子目录

配置 artifact 类型仓库的正确写法

在项目根目录的 composer.json 中添加 repositories 配置段，类型必须为 artifact，路径填绝对或相对于 composer.json 的目录路径：

{     "repositories": [         {             "type": "artifact",             "url": "./artifacts/"         }     ] }

注意：url 值末尾的斜杠 / 不能省，否则 Composer 会静默忽略该仓库；路径不支持 ../ 向上跨级（部分版本会失败），建议用同级目录。

• 执行 composer clear-cache 再运行 composer update 或 composer require vendor/name
• 如果包未被识别，运行 composer diagnose 查看是否报 Invalid repository type "artifact"（说明 Composer 版本太低，需 ≥ 1.0.0）
• artifact 仓库不支持版本别名（如 dev-master），必须使用 composer.json 中声明的精确版本号（如 1.2.3）

Zip 包里 composer.json 的关键字段不能少

哪怕只是临时测试，Zip 包根目录下的 composer.json 至少得有这三项，否则 Composer 扫描时会跳过该包：

{     "name": "acme/utils",     "version": "1.0.0",     "autoload": {         "psr-4": { "Acme": "src/" }     } }

• name 格式必须是 vendor/package，且和你 require 时写的完全一致
• version 必须是规范语义化版本（如 1.0.0），不能写 dev 或 latest
• 如果包没加 autoload，安装后无法自动加载类，require 会报 class not found
• 无需发布到 Packagist，也无需 dist/source 字段 —— artifact 模式只认 Zip 本身

为什么不用 path 仓库替代？

有人试过用 "type": "path" 指向解压后的目录，确实能 work，但它要求目标目录存在且可读，无法复现“分发一个 Zip 就能让别人安装”的场景。而 artifact 是唯一支持纯 Zip 分发的内置方案。

真正的坑在于：一旦配置了 artifact，Composer 会扫描整个目录下所有 .zip 和 .tar.gz，如果混入损坏包或命名冲突包（比如两个 acme/utils 但不同 version），可能触发不可预期的版本选择 —— 建议每个 artifact 目录只放当前项目明确需要的 Zip，并定期清理。