Composer源管理工具推荐_Composer切换镜像最佳实践【工具】-composer-PHP中文网

composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/是唯一可靠方式，因Composer 2.x+仅识别该单数键名、强制要求type值和尾斜杠HTTPS URL，缺一即静默失效。

composer源管理工具推荐_composer切换镜像最佳实践【工具】

直接用 composer config -g repo.packagist 就够了，不需要额外工具 —— 所有“Composer 源管理工具”本质都是对这条命令的包装，反而增加出错概率。

Composer 2.x+ 的镜像源逻辑非常明确：全局默认源只认 repo.packagist 这一个键名（单数、无 s、大小写敏感），且必须同时指定 type: "composer" 和带尾斜杠的 HTTPS URL。任何第三方工具若没严格遵循这三点，就等于白配。

写成 repos.packagist 或 repositories.packagist → 静默写入无效字段，composer config -g repo.packagist 查出来是空或 null
漏掉 composer 类型参数 → Composer 2.0+ 自动 fallback 到官方源，不报错也不提示
URL 缺末尾 / → 请求路径拼成 /composerpackages.json，直接 404，卡在 Downloading
用 HTTP 地址 → Composer 2.x 默认拒绝，报 Invalid repository type

这条命令不是“建议写法”，而是硬性要求：

-g：必须加，否则只改当前项目 composer.json，换目录就失效
repo.packagist：键名不能拼错，不能多 s，不能少 repo. 前缀
composer https://mirrors.aliyun.com/composer/：中间的 composer 是 type 值，不是注释；URL 必须 HTTPS + 末尾 /

正确示例：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

错误示例：composer config -g repos.packagist https://mirrors.aliyun.com/composer（多 s、缺 type、缺 /）

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

团队协作或 CI/CD 场景下，全局配置反而容易引发不一致问题：宝塔面板可能以 www 用户运行，GitLab Runner 可能用 gitlab-runner 用户，各自读取不同 ~/.composer/config.json。

进项目根目录，运行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉 -g）
它会自动在 composer.json 的 repositories 字段里安全合并 "packagist" 条目，不覆盖已有私有源
前提是原 repositories 是对象（如 "repositories": { "packagist": {} }），不是数组；如果是数组，命令会失败，需先手动转为对象
这个配置会被 Git 跟踪，新人拉代码后 composer install 自动走镜像，composer.lock hash 也一致

很多工具执行完就显示“切换成功”，但实际根本没生效。真验证只看两处：

运行 composer config -g repo.packagist，输出必须是完整 JSON 对象，形如：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
运行 composer diagnose，检查 “Repo:” 行是否匹配你设的镜像地址
想确认某次命令到底连了谁？加 -vvv 参数：composer install -vvv --repository-url=https://mirrors.huaweicloud.com/repository/php/，日志里会打印真实请求 URL

最容易被忽略的是：项目根目录下存在 composer.json 且含 "repositories" 字段时，全局配置完全失效 —— 这不是 bug，是 Composer 明确设计的优先级规则。