临时换源应使用--repository参数,它仅单次生效、不修改配置文件,优先级最高,覆盖项目和全局源配置,但只影响元数据获取,不影响dist文件下载地址。

临时换源执行 install/update 命令
不需要改全局配置,也能让某次 composer install 或 composer update 走指定镜像——关键在 --repository 参数。
它会临时覆盖 composer.json 里的 repositories 配置,直接走你给的 URL,跳过默认 packagist.org 和已配置的镜像源。
composer install --repository=https://packagist.phpcomposer.comcomposer update --repository=https://mirrors.aliyun.com/composer/
注意:这个参数只影响包元数据拉取(即 packages.json 列表),不改变实际 ZIP 包下载地址。如果镜像站没同步完整或缓存过期,仍可能 fallback 到官方源或报 404。
用 -g 配合 --repository 会出问题
别把 --repository 和 -g(全局模式)混用。前者是项目级行为,后者会尝试读取全局 composer.json,但 --repository 不作用于全局配置上下文,结果往往被忽略,甚至触发奇怪的认证错误。
常见现象:Could not authenticate against github.com,其实只是因为 Composer 在全局模式下误判了源类型,强行走 GitHub API。
- 要全局换源 → 改
~/.composer/config.json或运行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 要单次换源 → 只用
--repository,且确保当前目录有有效的composer.json
国内常用镜像源地址与兼容性
不是所有镜像都支持 --repository 直接对接。部分镜像(如腾讯云、华为云)要求加 /packages.json 后缀,否则返回 404;阿里云和 PHPComposer 则做了自动路由,直接填根域名即可。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 阿里云:
https://mirrors.aliyun.com/composer/(推荐,稳定,无需后缀) - PHPComposer:
https://packagist.phpcomposer.com(已基本停更,慎用) - 腾讯云:
https://mirrors.cloud.tencent.com/composer/packages.json(必须带/packages.json) - 华为云:
https://repo.huaweicloud.com/repository/php/packagist/packages.json
执行前建议先 curl -I https://xxx/packages.json 确认返回 200,避免命令卡住或静默失败。
为什么不用 config 命令临时设源?
composer config repo.packagist composer https://xxx 看似能“临时”改,但它会写入当前项目的 composer.json(或 composer.lock 相关字段),下次再 run 就真变了,不是真正意义上的“单次”。而且改完不 revert 的话,容易污染版本库。
相比之下,--repository 完全内存态,命令结束即失效,适合 CI/CD 流水线或排查网络问题时快速验证。
真正临时,就得靠参数,而不是配置项。这点容易混淆,尤其当文档里把 config 和 --repository 放一起讲时。










