企业级Composer私有仓库搭建与配置实战-composer-PHP中文网

根本原因是未显式禁用packagist.org，默认源优先导致私有包不被匹配；必须在repositories数组中添加{"packagist.org": false}，且url末尾斜杠不可省略，仓库类型须为composer。

企业级composer私有仓库搭建与配置实战

为什么`composer.json`里加了私有仓库URL却还是找不到包

根本原因不是URL写错了，而是Composer默认仍会先查packagist.org，私有仓库只是fallback——哪怕你明确写了Artifactory或Satis地址，只要没关掉默认源，私有包就永远不会被匹配。

必须在项目级composer.json中显式禁用：

{
  "repositories": [
    {
      "type": "composer",
      "url": "https://artifactory.example.com/artifactory/api/composer/my-virtual-repo/"
    }
  ],
  "packagist.org": false
}

"packagist.org": false这一行不能省，漏掉就会报Could not find package vendor/name，即使该包100%存在
Artifactory仓库URL末尾的斜杠/必须保留，少一个就会404；路径中/api/composer/也不能替换成/api/npm/之类
如果用了虚拟仓库聚合多个源，确保它后端至少包含一个type: composer的本地或远程仓库，Generic类型仓库不兼容

Artifactory上创建Composer仓库时最容易配错的三项

不是所有仓库类型都能被Composer识别。Artifactory必须创建原生composer类型仓库，Generic、Remote（非composer）、Virtual（未启用composer协议）都会导致composer install直接失败，错误信息通常是Invalid repository type或元数据解析异常。

Discussion Composer

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

下载

仓库类型必须选Local、Remote或Virtual，但“Package Type”下拉框要手动选composer，不是默认值
Remote仓库的“URL”字段填的是上游源（如https://packagist.org），不是你自己项目的Git地址；若想代理Packagist，这里必须填官方地址
Virtual仓库的“Repositories”列表里，必须把已启用的composer本地/远程仓库拖进去，且勾选“Enable Default Deployment Repository”，否则composer publish会拒绝上传

Satis构建后`composer update`仍走外网的三个检查点

Satis生成的是静态文件，不提供动态API服务。如果composer update还在连packagist.org，说明客户端根本没读到你的镜像源——问题一定出在链路中间某处。

确认packages.json能被直接curl -I https://satis.example.com/packages.json访问到，返回200；如果Nginx返回403或404，Composer会静默fallback
项目composer.json里的url值必须以/结尾，比如"https://satis.example.com/"，写成"https://satis.example.com"会导致Composer拼出https://satis.example.com/packages.json（多了一层）
satis.json中"require-all": true要设为true，否则只收录"require"里明确定义的包；若留空或设false，Satis不会报错，但生成的packages.json里压根没有你的私有包

私有包上传后install失败：认证与命名的硬性约束

Artifactory和Satis对私有包的命名、上传方式、认证路径都有强约定，违反任意一条都会卡在install阶段。

包名必须符合vendor/name格式（如acme/utils），不能是utils或acme-utils；Composer不接受下划线或短横以外的分隔符
Artifactory上传必须用composer publish命令或调用/api/composer/ REST API，直接Web UI上传ZIP文件无效——元数据不会生成
auth.json的域名必须和仓库URL的host完全一致（包括端口），例如artifactory.example.com:8081和artifactory.example.com被视为两个不同域，认证会失败