适合自动化部署配置的Composer国内镜像-composer-PHP中文网

ci/cd 中 composer config -g 配镜像失效是因为它仅修改当前用户配置，而 ci 环境使用不同用户执行命令，导致配置不可见；正确做法是用 --repository-url 参数或环境变量 composer_repo_packagist（≥2.5），或项目级配置追加 repositories，同时注意 url 格式、清缓存及验证日志。

适合自动化部署配置的composer国内镜像

CI/CD 里 composer config -g 配镜像为什么总失效

因为 composer config -g 写的是当前用户的 ~/.composer/config.json，而 GitHub Actions、GitLab CI、Jenkins 默认用 runner 或 git 用户执行命令，Docker 构建里可能是 www-data 或自定义用户——它们都读不到你本地配的配置。

别在 CI 脚本里写 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，它只改了构建机上某个用户的配置，对后续步骤无效
正确做法是用 --repository-url 参数临时指定： composer install --repository-url=https://mirrors.aliyun.com/composer/
如果要用 composer update，也得带上参数：composer update --repository-url=https://mirrors.aliyun.com/composer/
部分 CI 环境（如宝塔部署脚本）支持预设环境变量，可设 COMPOSER_REPO_PACKAGIST=https://mirrors.aliyun.com/composer/，但需确认 Composer 版本 ≥ 2.5（旧版不识别）

项目级配置如何避免破坏私有仓库

直接运行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加 -g）会自动向 composer.json 的 repositories 字段安全追加，前提是已有 "repositories": {} 或 "repositories": [] 结构。

Discussion Composer

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

下载

若 composer.json 原本是 "repositories": []，命令会报错；此时先手动改成 "repositories": {} 再运行
千万别手写 "packagist.org": false 放进 repositories 里——这会导致扩展校验失败，比如 ext-json 报错
真正要禁用官方源，必须在 composer.json 根节点写："packagist.org": false（和 repositories 同级）
已有 Git 私有包源？这条命令不会覆盖，只会追加 "packagist" 键，Composer 2.2+ 会按顺序合并

验证镜像是否真在生效的唯一可靠方式

光看 composer install 是否完成没用，卡住时根本看不出走的是哪个源。必须加 -vvv 并盯日志里的 HTTP 请求域名。

运行 composer require monolog/monolog -vvv，滚动日志中找类似 Downloading https://mirrors.aliyun.com/composer/p2/monolog/monolog.json 这样的行
如果看到 packagist.org 或 repo.packagist.org，说明镜像没生效，哪怕 composer config -g repo.packagist 输出看起来正常
注意：composer show -p 只显示配置项，不反映实际请求行为；composer config -g repo.packagist 返回空、null 或 https://packagist.org，说明根本没写进去
首次换源后务必清缓存：composer clear-cache，并删掉 vendor/ 和 composer.lock，否则旧 lock 文件仍锁定海外地址

阿里云/腾讯云/华为云镜像 URL 差异与兼容性

三个主流镜像 URL 行为不完全一致，尤其末尾斜杠和协议处理，直接影响 Composer 是否请求成功。

阿里云：https://mirrors.aliyun.com/composer/ ✅ 必须带末尾斜杠，缺斜杠会拼出 /composerpackages.json 导致 404
腾讯云：https://mirrors.cloud.tencent.com/composer/ ✅ 同样要求末尾斜杠，路径结构与阿里云一致
华为云：https://mirrors.huaweicloud.com/repository/php ❌ 末尾不带斜杠，且路径不是 /composer/；Composer 2.2+ 会自动补全，但部分老版本可能 fallback 到官方源
所有镜像必须用 HTTPS；HTTP 地址会被 Composer 2.0+ 直接拒绝，连尝试都不会做

镜像配置本身不复杂，但每个环节都依赖精确匹配：键名、type、URL 格式、用户上下文、缓存状态、lock 文件一致性——少一个，就静默退回到 packagist.org。