用于生产环境的Composer国内镜像推荐-composer-PHP中文网

阿里云镜像https://mirrors.aliyun.com/composer/是生产环境首选，因其同步频率高（每10分钟）、https证书兼容性好、支持composer 2.2+签名验证；配置必须严格满足三要素：键名repo.packagist、type值composers、url以https加末尾斜杠结尾，且需执行composer clear-cache并删除vendor与composer.lock后重装验证。

用于生产环境的composer国内镜像推荐

阿里云镜像最适配生产环境

阿里云镜像 https://mirrors.aliyun.com/composer/ 是当前生产环境首选，同步频率高（每10分钟）、HTTPS证书兼容性好、元数据完整，且明确支持 Composer 2.2+ 的签名验证机制。清华源已关闭，腾讯云镜像近期偶发 503，中科大镜像在公网环境下响应不稳定——这些都不适合要求高可用的生产部署。

必须用 HTTPS + 末尾斜杠：https://mirrors.aliyun.com/composer/ ✅；https://mirrors.aliyun.com/composer ❌（少斜杠会拼出错误路径导致 404）
不推荐用已停更的 https://packagist.phpcomposer.com，它不支持 Composer 2.5+ 的 signature 校验，上线时会报 Invalid signature
华为云镜像 https://mirrors.huaweicloud.com/repository/php/ 可作备选，但新包同步延迟略高，上线前建议实测关键依赖是否能即时拉取

全局配置命令必须写对三要素

composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 这条命令极易静默失败：不报错、不提示，但实际没生效。验证方式只有一条：composer config -g repo.packagist，输出必须是完整 JSON 对象，形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。

Discussion Composer

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

下载

repo.packagist 是固定键名，写成 repos.packagist 或 repositories.packagist 都无效
中间的 composer 是 type 值，不是注释，漏掉就直接 fallback 到官方源
URL 必须 HTTPS 开头、末尾带 /，否则 Composer 会尝试请求 /composerpackages.json 这类不存在的路径

CI/CD 和宝塔环境不能依赖全局配置

GitHub Actions、GitLab CI、宝塔「一键部署」默认以 runner 或 www 用户执行命令，读不到 /root/.composer/config.json。全局配置在这里基本失效。

CI 中应显式指定源：composer install --repository-url=https://mirrors.aliyun.com/composer/，避免污染项目配置
宝塔环境下，先确认 PHP 任务运行用户（通常是 www），再执行：sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
若项目需长期锁定镜像，应在项目根目录运行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加 -g），它会安全合并进 composer.json 的 repositories 字段

换源后仍卡在 Loading repositories？清缓存是硬性步骤

镜像配置正确 ≠ 立刻生效。Composer 优先读本地缓存和 composer.lock 中记录的旧地址，哪怕你刚配完新源，它仍可能反复尝试连接 packagist.org。

必须执行：composer clear-cache
删掉项目下的 vendor/ 和 composer.lock
再运行：composer install -vvv，观察日志中是否出现 mirrors.aliyun.com 请求记录
如果仍卡住，用 curl -I https://mirrors.aliyun.com/composer/packages.json 手动测试连通性；返回非 200 或 SSL 报错，说明系统根证书过期，需运行 sudo update-ca-certificates

配置本身不复杂，但每个环节都存在“静默失效”风险——键名错一位、少个斜杠、缓存没清、用户权限不对，都会让镜像形同虚设。生产环境上线前，务必逐项验证输出、日志和网络连通性，而不是只看命令有没有报错。