Composer自定义仓库配置不生效？常见原因与排查步骤-composer-PHP中文网

根本原因是项目级 repositories 数组一出现，composer 就默认关闭隐式 packagist.org 源且不自动补回；必须显式添加 packagist 官方源并设 "packagist": false，否则包查找失败。

composer自定义仓库配置不生效？常见原因与排查步骤

为什么加了repositories还是去packagist.org找包？

根本原因不是“没配”，而是项目级 repositories 数组一出现，Composer 就默认关闭隐式 packagist.org 源——但它不会帮你把 packagist 加回来，也不会报错提醒你缺了它。

结果就是：你写了私有 Git 仓库，composer require myorg/sdk 却仍去官方源查，报 Could not find package。

必须显式补上 packagist 官方源，并标记 "packagist": false，否则它不参与查找
推荐写法：把私有源放 repositories 数组最前面，再追加一条：{"type": "composer", "url": "https://packagist.org/", "packagist": false}
别用 composer config -g packagist false 全局关掉——影响所有项目，且 Composer ≥ 2.2 已不认这个键名

repositories里URL写对了，但提示invalid repository？

Composer 在解析 repositories 时就做硬校验，根本不会发 HTTP 请求。报这个错，90% 是配置本身违反了 type 和 url 的绑定规则。

Discussion Composer

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

下载

type: "composer" → URL 必须是 HTTPS + 末尾带 /，例如 https://mirrors.aliyun.com/composer/；少斜杠、用 HTTP、或路径错一层（如 /api/packages.json）都会直接判无效
type: "vcs" → URL 必须是可 git clone 的地址，含 .git 后缀，例如 https://gitlab.example.com/myorg/sdk.git；网页地址、release 页面链接、没 .git 的 URL 全部静默失败
type: "package" → 不需要 url 字段，但必须提供完整对象，含 name、version、dist 或 source
运行 composer diagnose，它会明确指出哪条 repository “failed to parse”

私有Git包require失败，版本始终匹配不上？

Git 仓库不靠 packages.json 提供版本列表，而是靠分支名、tag 名动态解析。所以 composer require 写的版本字符串，必须和 Git 引用严格对应。

dev-main → 要求仓库存在 main 分支，且该分支根目录 composer.json 中 "name" 为 myorg/sdk（两段式），"version" 可为空
v1.2.3 → 要求仓库有 v1.2.3 tag，且该 tag 指向的 composer.json 中 "version" 字段值**必须等于 "1.2.3"**（不能是 "v1.2.3" 或 "1.2.3-beta"）
验证方式：手动执行 git ls-remote -h https://gitlab.example.com/myorg/sdk.git，看是否能列出 refs/heads/main 或 refs/tags/v1.2.3
别信 GitHub/GitLab 网页上显示的 tag 名——用命令行确认真实 ref 名称

全局镜像配置明明写了，install时却还在连packagist.org？

Composer 的源优先级是「项目级 > 全局 > 默认」，没有协商，没有 fallback。只要项目 composer.json 里有 "repositories" 这个 key（哪怕值是 [] 或 {}），全局配置就彻底失效。

快速检查：运行 composer config repositories，看输出是否含你配的镜像 URL
临时禁用项目级配置：composer config --unset repositories（注意无 -g）
CI/CD 或 Docker 中，COMPOSER_HOME 常被覆盖：运行 composer config --global home，确认输出路径和当前 PHP 进程用户实际可访问的 $HOME/.composer 一致
Composer ≥ 2.2 全局镜像必须分两行设：composer config -g repositories.packagist.org.type composer 和 composer config -g repositories.packagist.org.url https://mirrors.aliyun.com/composer/