Composer项目配置文件中repositories仓库配置详解-composer-PHP中文网

composer 添加 repositories 后 require 不生效，是因为手动声明 repositories 会关闭默认 packagist.org 源，且不自动 fallback；vcs 仓库仅当包名完全匹配其 composer.json 中的 name 时才解析，且 url 必须带 .git 后缀、可被 git clone 直接访问。

composer项目配置文件中repositories仓库配置详解

加了 repositories 却 composer require 不生效，不是配置写错了，而是 Composer 根本没去你写的地址查包——它默认只认 packagist.org，且一旦你手动声明了 repositories 数组，这个默认源就会被完全关闭。

为什么加了 repositories 还是找不到包

根本原因是 Composer 不会“自动 fallback”到你配的仓库，它只按顺序匹配：找到第一个能提供该包名（vendor/name）的仓库就停，后面全忽略。而 vcs 类型仓库压根不参与全局索引，只在你 require 的包名**恰好等于其 composer.json 里声明的 name** 时才临时解析 Git 分支/Tag。

repositories 是包发现路径表，不是“多源搜索开关”
没显式加上 {"type":"composer","url":"https://packagist.org","packagist":false}，连 monolog/monolog 都会报错
vcs 仓库 URL 缺 .git 后缀（如写成 https://gitlab.com/myorg/sdk），Composer 会静默跳过，不报错也不提示
私有 Git 仓库返回 401/403，大概率是 auth.json 没放对位置，或域名 key 和 URL 域名不一致（比如 URL 是 gitlab.example.com，但 auth.json 写的是 gitlab.com）

type: "vcs" 的 URL 必须满足哪些条件

vcs 类型不是“随便填个网页链接”，它要求地址必须能被 git clone 直接消费，且 Composer 能无交互访问。

Pandas 配置文件报告生成器

使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。

下载

必须带 .git 后缀：https://gitlab.example.com/myorg/sdk.git ✅，https://gitlab.example.com/myorg/sdk ❌
不能是 HTML 页面地址：https://gitlab.example.com/myorg/sdk/-/tree/main 或 /releases/tag/v1.2.0 都无效
HTTPS 方式带 token 的写法（如 https://token:x-oauth-basic@...）在 Composer 1.10+ 已废弃，必须走 auth.json
验证是否真正可达：终端执行 git ls-remote -h https://gitlab.example.com/myorg/sdk.git，能列出分支才算通

如何让私有包和公共包共存不冲突

关键不是“加多个源”，而是控制路由优先级和兜底行为。项目级 composer.json 中的 repositories 数组决定所有包的查找路径，顺序即优先级。

私有源放前面：{"type":"vcs","url":"https://gitlab.example.com/myorg/internal-sdk.git"}
紧接着补一条 Packagist 兜底：{"type":"composer","url":"https://packagist.org","packagist":false}（注意不是删掉，是显式禁用）
URL 末尾斜杠不能省："https://my-satis.example.com/" ✅，"https://my-satis.example.com" ❌（会拼出错误路径）
别混用类型：同一个逻辑用途下，不要把 vcs 和 composer 源写进同一组路由逻辑；需要强制指定某包走某源，用 type: "package" 手动声明元数据

auth.json 放哪、怎么写才真正起作用

90% 的认证失败不是 Token 无效，而是文件没被读到——Composer 对路径和字段名极其敏感，且静默跳过错误配置。

位置必须是项目根目录下的 auth.json，或全局 ~/.composer/auth.json；CI 环境建议放项目内并 gitignore 掉敏感值
域名 key 必须和仓库 URL 完全一致（包括端口、子域）："gitlab.example.com" ≠ "git.example.com"
字段名只能是 http-basic 或 github-oauth，不能写成 http_auth 或 token
权限必须是 600（Linux/macOS）：运行 chmod 600 auth.json，否则 Composer 会直接忽略