Composer config命令设置_Composer配置镜像源与环境变量-composer-PHP中文网

composer config -g repo.packagist 必须带 composer 类型参数，因为 composer 全局镜像仅识别 {"type": "composer", "url": "..."} 结构，缺省或错误 type 会导致静默回退至 packagist.org；url 必须以 / 结尾，否则拼接 packages.json 时 404。

composer config命令设置_composer配置镜像源与环境变量

composer config -g repo.packagist 是唯一能稳定生效的全局镜像配置命令，其他写法（比如漏掉 composer 类型、拼错键名、URL 缺末尾 /）都会静默失败——命令不报错，但 composer install 依然连 packagist.org。

为什么 `composer config -g repo.packagist` 必须带 `composer` 这个 type 参数

Composer 的全局镜像逻辑只认 repo.packagist 这个固定键名，且要求值必须是形如 {"type": "composer", "url": "https://..."} 的对象。命令里中间那个 composer 就是强制指定 type 字段的值：

漏掉它（例如写成 composer config -g repo.packagist https://mirrors.aliyun.com/composer/），Composer 2.x 会 fallback 到默认源，不报错也不警告
写成 vcs 或 package，会导致解析失败，composer diagnose 会显示 Repo packagist.org: [error]
验证是否写对：运行 composer config -g repo.packagist，输出必须是完整 JSON，且含 "type": "composer"

URL 必须以 `/` 结尾，否则 404

Composer 拼接元数据路径时，会在你给的 URL 后直接加 packages.json。如果 URL 是 https://mirrors.aliyun.com/composer（没斜杠），最终请求的是 https://mirrors.aliyun.com/composerpackages.json —— 显然 404。

Discussion Composer

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

下载

正确写法只有这一种：https://mirrors.aliyun.com/composer/
阿里云、腾讯云、Laravel China 镜像都要求这个结尾，不是可选
Windows 用户改完要重开终端，否则 composer config -g repo.packagist 查不到新值（环境变量未刷新）

项目级配置会覆盖全局，且写法更严格

只要项目根目录的 composer.json 里有 repositories 字段，全局设置就完全失效。这不是 bug，是 Composer 的设计优先级。

不能只写 {"type":"composer","url":"..."}，必须显式禁用默认源：{"packagist.org": false} 要放在 repositories 数组第一个位置

完整结构示例：

{"repositories": [{"packagist.org": false}, {"type":"composer","url":"https://mirrors.aliyun.com/composer/"}]}

用 composer config repo.packagist ...（不带 -g）会全量替换整个 repositories 字段，可能清掉你已有的私有源
CI/CD 或 Docker 构建中，务必确认执行命令的用户和读取配置的用户一致（比如 www-data 用户读不到 root 写的全局配置）

`COMPOSER_MIRROR` 环境变量根本不起作用

Composer 官方不识别 COMPOSER_MIRROR 这类自定义变量。它只认 COMPOSER_HOME、COMPOSER_CACHE_DIR 等少数预设变量。

export COMPOSER_MIRROR=https://... 不会改变任何源地址
想动态切镜像，只能在脚本里调用 composer config -g repo.packagist composer $MIRROR_URL，并确保先清除旧配置
真正影响下载行为的是 composer.lock 里的 dist.url，所以改完镜像后必须删掉 vendor/ 和 composer.lock，再跑 composer install
验证是否真走镜像：加 -vvv 运行，搜日志里的 GET https://mirrors.aliyun.com/，别信“下载变快了”这种模糊判断