一键脚本搞定Composer国内镜像配置-composer-PHP中文网

composer install卡在loading package information的根源是未切换国内镜像源，应执行composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/（v2）并清缓存，注意版本差异与ci环境隔离配置。

一键脚本搞定composer国内镜像配置

Composer install 时卡在 loading package information 怎么办

大概率是默认源 packagist.org 在国内 DNS 解析慢或连接不稳定。这不是网络问题，而是 Composer 默认没走 HTTPS 代理、也没预设国内镜像，每次请求都要绕行海外 CDN 节点。

解决方式不是换网络，而是让 Composer 主动用国内镜像源。最直接的办法是改全局配置，但要注意：不同 Composer 版本（v1 / v2）的配置命令和字段名不一致，混用会导致 composer.json 被写入无效字段，后续执行 composer update 可能报错。

v1 用 composer config -g repo.packagist composer https://packagist.phpcomposer.com（已停用，别再用）
v2 必须用 composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/（注意是 repos.packagist，不是 repo.packagist）
阿里云镜像目前最稳，清华源偶尔同步延迟，华为云镜像需登录账号才能用完整服务

一键脚本里怎么判断 Composer 版本并自动适配

不能硬写死 v1 或 v2 的命令，得先查版本。用 composer --version 输出里含 2. 就是 v2，含 1. 就是 v1；但要注意有些旧系统装的是 composer.phar 直接运行，输出格式略有不同，所以脚本里得用正则提取主版本号。

示例核心逻辑（bash）：

COMPOSER_VERSION=$(composer --version | grep -oE 'version [0-9]+\.[0-9]+' | cut -d' ' -f2 | cut -d. -f1)
if [ "$COMPOSER_VERSION" = "2" ]; then
  composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/
else
  composer config -g repo.packagist composer https://packagist.phpcomposer.com
fi

但注意：PHP Composer v1 已于 2022 年 3 月停止维护，phpcomposer.com 镜像也早已下线，所以实际脚本中应直接拒绝 v1，提示用户升级：composer self-update。

Discussion Composer

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

下载

为什么设置了镜像，`composer create-project` 还是慢

因为 create-project 默认会先 clone 模板仓库（比如 laravel/laravel），这步走的是 Git 协议，跟 Composer 源无关。如果项目模板里 composer.json 锁定了某些包的特定版本或用了私有源，Composer 仍会尝试连原始源拉取元数据。

检查模板项目的 composer.json 是否含 "repositories" 字段，有的话会覆盖全局镜像设置
加 -vvv 参数看具体卡在哪一步：composer create-project laravel/laravel test --vvv
临时禁用模板里的自定义源：加 --no-plugins --no-scripts，再手动进目录跑 composer install

CI 环境下怎么安全地批量配置镜像

CI（如 GitHub Actions、GitLab CI）里不能依赖用户全局配置，必须在每次 job 中显式设置。用 composer config 写入 $HOME/.composer/config.json 是可行的，但要注意并发 job 可能冲突 —— 更稳妥的是用 COMPOSER_HOME 环境变量隔离配置路径。

例如 GitHub Actions 中：

- name: Set Composer mirror
  run: |
    mkdir -p $HOME/composer-config
    COMPOSER_HOME=$HOME/composer-config composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/

这样每个 job 用独立配置目录，不会互相污染。另外，Docker 构建中若复用 base image，记得在 Dockerfile 里用 RUN 设置镜像，而不是靠构建时传参 —— 否则缓存层可能跳过配置步骤。

镜像配置本身很简单，真正容易出问题的是版本判断逻辑、CI 环境隔离、以及模板项目自带的 repository 覆盖行为。这些地方不细看日志，很容易以为“脚本跑过了就万事大吉”。