composer镜像配置必须验证是否生效，正确方式是全局配置composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/并用clear-cache && require -vvv确认请求地址；install与update须严格区分场景，ci/cd中禁用update；docker和ci需显式配置镜像源。

Composer 镜像配置不是“配了就快”，而是必须验证是否真正在用；开发工作流里最常出问题的不是命令写错，而是 install 和 update 混用、lock 文件未提交、或镜像被项目级配置覆盖。

composer config -g repo.packagist 是唯一安全的全局配置方式

手动编辑 ~/.composer/config.json 或 %APPDATA%\Composer\config.json 极易因逗号遗漏、缩进错误或字段名拼错（比如写成 repos.packagist）导致后续所有 composer 命令直接报 file_get_contents(): Failed to open stream。而 composer config -g 会自动识别路径、校验 JSON、安全写入，并保留已有字段（如 auth.json 中的 token）。

• 正确命令只有这一条：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
• 错误操作包括：composer config repo.packagist（漏 -g → 写进当前项目）、sudo composer config -g（Linux/macOS 下写进 root 用户配置）、字段名写成 repositories.packagist.org（Composer 不识别，静默忽略）
• 若之前误配过，先清理：composer config -g --unset repositories.packagist

验证镜像是否生效不能只看 config 输出

composer config -g repo.packagist 只显示“你写了什么”，不代表 Composer 实际请求了该地址。真正有效的验证方式是触发一次真实网络请求：

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 && composer require monolog/monolog -vvv
• 在日志中搜索 Downloading，确认出现的是：Downloading https://mirrors.aliyun.com/composer/packages.json
• 如果看到 https://packagist.org/packages.json 或 https://repo.packagist.org/packages.json，说明当前目录下的 composer.json 里有 "repositories" 字段，它覆盖了全局配置

install 与 update 必须严格区分使用场景

这不是习惯问题，而是环境控制权的问题：

• composer install：只读 composer.lock，装里面记录的**确切版本**。CI/CD、生产部署、新同事首次 setup —— 唯一该用的命令
• composer update：忽略 composer.lock，重算整个依赖树，改锁文件。仅应在明确要升级某个包、且已人工审查变更时使用
• 首次运行 composer install 时若无 composer.lock，它会 fallback 成 update 并生成锁文件 —— 这等于绕过团队共识。建议提前 git commit 一个空锁文件，或由负责人统一生成并提交
• CI 脚本里一旦出现 composer update，就等于把版本控制权交给了网络和时间 —— 凌晨告警大概率由此而来

Docker 环境下镜像配置容易被忽略的细节

在容器中执行 composer install 时，宿主机的全局镜像配置默认不生效，因为 COMPOSER_HOME 指向容器内路径：

• 推荐做法：在 docker-compose.yml 中挂载宿主机的 Composer 缓存和配置：volumes: - ~/.composer:/root/.composer
• 或更稳妥地，在 Dockerfile 中写死镜像源：RUN composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
• CI 环境（如 GitHub Actions）默认不读全局配置，需显式设置 COMPOSER_HOME 或改用项目级 repositories 配置
• 注意：Docker 构建阶段若用 composer install --no-dev --optimize-autoloader --classmap-authoritative，必须确保 composer.lock 已提交且未被 .gitignore 排除 —— 否则构建结果不可控