执行 composer install 时可用 --repository-url 参数临时换源,如 composer install --repository-url https://mirrors.aliyun.com/composer/,仅本次生效且不修改配置;永久换源用 composer config -g repo.packagist composer URL;项目级配置则去掉 -g 参数。

执行 composer install 时临时换源
不需要改全局配置,加 --repository-url 参数就能指定本次命令用的镜像源。比如用阿里云镜像:
composer install --repository-url https://mirrors.aliyun.com/composer/
这个参数只影响当前命令的包下载行为,不修改 composer.json 或全局配置,适合 CI/CD 流水线或临时调试。
- 仅对
install、update、require等需要拉取包的命令生效 - 如果项目已锁定了
composer.lock中的 dist URL,该参数可能被忽略(此时需先删 lock 文件或加--ignore-platform-reqs配合验证) - 注意 URL 必须带协议(
https://),末尾斜杠可有可无
永久切换全局镜像源(推荐国内用户)
运行一次命令即可覆盖默认 packagist.org 源:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
这条命令会写入 ~/.composer/config.json,之后所有项目(除非显式覆盖)都会走这个镜像。腾讯、华为云镜像同理,只需替换 URL:
- 腾讯:
https://mirrors.cloud.tencent.com/composer/ - 华为云:
https://repo.huaweicloud.com/repository/php/ - 清华:
https://packagist.phpcomposer.com(已停更,不建议)
执行后可通过 composer config -g repo.packagist 查看是否生效;若想恢复官方源,运行 composer config -g --unset repo.packagist。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论(Discussion)”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性,以及撰写结论。当用户输入以下任一指令时也会自动触发该功能: - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
项目级镜像配置(避免污染全局)
在项目根目录下运行(不加 -g):
composer config repo.packagist composer https://mirrors.aliyun.com/composer/
这会在当前项目的 composer.json 中新增 repositories 字段,只对该仓库生效。适合团队协作中统一源策略,也方便 Git 跟踪。
- 注意:如果
composer.json已存在repositories数组,该命令会合并而非覆盖 - 某些老旧版本 Composer(composer.json,会 fallback 到
composer.lock同级的composer.repositories.json(已废弃,尽量升级) - CI 环境中若使用缓存,记得清理 vendor 和 lock 文件,否则旧源可能仍被复用
常见错误:执行后还是连不上 packagist.org
不是镜像没生效,而是 Composer 默认启用了「包元数据缓存」,它可能还记着旧的源地址。典型表现是报错信息里仍有 packagist.org 字样,即使你已经配了镜像。
- 先清缓存:
composer clear-cache - 再确认实际请求地址:
composer install -vvv,观察输出里Downloading https://...的 URL 是否为你设置的镜像 - 如果用了 Docker,确保镜像配置写在构建阶段前,且容器内没有残留的
~/.composer/config.json - 企业内网环境还需检查是否被代理或防火墙拦截——镜像源只是换地址,不解决网络连通性问题
镜像源本质是 HTTP 服务代理,换源解决的是速度和可用性,不是认证或权限问题;如果提示 401 Unauthorized 或 SSL certificate problem,那得查证书或私有库配置,跟镜像无关。

















