CI/CD环境下必须用项目级镜像配置，因全局配置composer config -g在GitHub Actions、GitLab CI、Docker等中默认无效；应执行composer config repo.packagist composer https://mirrors.aliyun.com/composer/写入composer.json，并删缓存、vendor和composer.lock后运行composer install -vvv验证日志是否命中镜像域名。

CI/CD 环境下必须用项目级镜像配置

全局配置 composer config -g 在 GitHub Actions、GitLab CI、Docker 构建等场景中基本无效——因为这些环境默认以非交互式用户（如 runner、www 或容器内无主用户）运行，读不到你本地 ~/.composer/config.json。项目级配置写进 composer.json 才能随代码一起流转，确保所有环境行为一致。

• 进项目根目录后执行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意不带 -g）
• 该命令会自动在 composer.json 的 repositories 字段下安全添加 "packagist": {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
• 若原 composer.json 中 "repositories" 是数组（[]），命令会报错；需先手动改为 "repositories": {} 再重试
• 切勿手写 "packagist.org": false —— 这会直接禁用基础包源，连 php 或 ext-json 都无法校验

换源后依赖安装仍卡住？清缓存和 lock 文件是硬性步骤

镜像只影响元数据下载和包文件拉取，但 Composer 会优先复用 composer.lock 和本地缓存里的旧地址。哪怕你刚配好阿里云镜像，只要 composer.lock 里还存着 packagist.org 的 hash，它就会继续往海外源发请求。

Discussion Composer

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

下载

• 必须依次执行：composer clear-cache → 删除 vendor/ 目录 → 删除 composer.lock
• 再运行 composer install -vvv，观察日志是否出现 mirrors.aliyun.com 或 Downloading https://mirrors.aliyun.com/composer/
• 不要用 composer update 替代 install：前者触发依赖解析，后者才真正走新镜像下载

宝塔/Docker 多用户环境下镜像失效的根源

宝塔面板默认用 www 用户跑 PHP CLI，而你终端里执行的 composer config -g 是写进当前 shell 用户（如 root 或 admin）的配置。两者配置文件路径不同，根本互不可见。

• 在宝塔中，先确认 PHP CLI 是否启用关键函数：检查「PHP 管理」→「禁用函数」中是否移除了 putenv、proc_open、pcntl_signal
• 切换用户执行镜像配置：sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
• Docker 中推荐改用 --repository-url 参数兜底：composer install --repository-url=https://mirrors.aliyun.com/composer/，它优先级最高，绕过所有配置文件

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

别信命令返回“success”，也别只看 composer config -g repo.packagist 输出 JSON —— 这只能说明配置写进了文件，不代表运行时生效。真正有效的是 Composer 实际发起的 HTTP 请求域名。

• 加 -vvv 参数运行：composer install -vvv 2>&1 | grep -i "downloading\|resolving\|mirrors\|packagist"
• 看到类似 Downloading https://mirrors.aliyun.com/composer/p2/monolog/monolog.json 才算成功
• 如果日志里混着 https://packagist.org/packages.json 或 403 Forbidden，说明被项目级 repositories 覆盖，或 URL 少了末尾 / 导致拼出 /composerpackages.json 404
• Composer ≥2.2 推荐用 repos.packagist.org 键名替代 repo.packagist，尤其在需要精确匹配子域名请求时更稳定

实际部署时最容易忽略的是：镜像只管下载，不管依赖解析。如果 composer update 卡在 Resolving dependencies，问题出在 composer.json 里宽泛的版本约束（比如 "^7.4 || ^8.0"）或未锁定的 dev 分支，跟镜像配置无关。