/etc/composer/config.json是唯一真正全局的镜像配置路径，Composer 2.2+优先加载且不依赖用户HOME；需确保目录存在、权限755、文件644、JSON结构正确（repositories为对象、packagist.org键、URL以/结尾HTTPS），并用实际运行用户（如www-data）验证生效。
用 /etc/composer/config.json 实现系统级镜像覆盖
集群中不能靠 composer config -g 批量下发，因为该命令写入的是用户家目录（如 /root/.composer/config.json），而 PHP 项目实际运行用户（如 www-data）根本读不到。Composer 2.2+ 支持的 /etc/composer/config.json 是唯一真正全局、不依赖用户环境的路径，优先级高于所有其他配置。
必须确保：
-
/etc/composer/目录存在且权限为755，属主root:root - 配置文件内容结构正确，
"repositories"必须是对象（不是数组），键名为"packagist.org" - URL 必须以
/结尾，且为 HTTPS；例如："url": "https://mirrors.aliyun.com/composer/" - 文件权限设为
644，否则 Composer 会静默忽略
示例配置片段：
{
"config": {},
"repositories": {
"packagist.org": {
"type": "composer",
"url": "https://mirrors.aliyun.com/composer/"
}
}
}
为什么不能用 ansible + composer config -g 批量配
Ansible 或 shell 脚本常以 root 身份执行 composer config -g，但 PHP-FPM 或 CLI 运行时用的是 www-data、nginx 等低权限用户，它们的 $COMPOSER_HOME 默认指向各自家目录（如 /var/www/.composer），而该目录往往不存在或不可写。
常见失败现象：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
sudo -u www-data composer config -g repo.packagist ...报错Could not write to /var/www/.composer/config.json - 手动创建
/var/www/.composer后仍失败，因www-data用户无 shell（/sbin/nologin），sudo -i -u www-data会直接退出 - 即使写入成功，CI 流水线用
runner用户构建，又得重配一遍——本质是重复劳动
验证是否真生效：别只看 root 用户
验证必须用**实际运行 PHP 的用户**执行，否则毫无意义。比如 Nginx + PHP-FPM 场景下，应使用 www-data：
- 运行
sudo -u www-data composer config repo.packagist，输出应为镜像 URL 对象 - 运行
sudo -u www-data composer diagnose，确认不报Could not fetch packages.json - 关键一步：用目标用户实测拉包，
sudo -u www-data composer show monolog/monolog | head -3，观察是否秒出结果而非卡在Loading composer repositories
如果 composer config -g repo.packagist 在 root 下显示正常，但 www-data 下为空，说明配置没落到对的地方。
私有包和镜像源必须分离，否则 CI 构建必挂
中台架构下，团队通常既有公开包（走阿里云镜像），又有内部 Git 包（如 acme/core-utils）。若把私有仓库也塞进 repositories 对象里，Composer 会尝试从镜像站拉 Git 包，必然失败。
正确做法是：系统级配置只管 packagist.org，私有源必须由项目级 composer.json 显式声明，且 type 设为 vcs：
- 删掉
/etc/composer/config.json里任何非packagist.org的仓库项 - 每个微服务的
composer.json中，"repositories"应为数组，首项{"packagist.org": false}，次项才是镜像，再之后追加vcs类型私有源 - 改完后务必删除
vendor和composer.lock，再跑composer install，否则旧 lock 文件仍会回源
最易被忽略的一点：系统级配置虽强，但它无法替代项目级契约。镜像只是加速通道，而依赖解析逻辑、平台约束（config.platform）、私有包可见性，全靠 composer.json 本身定义。漏掉任何一环，集群里总有某台机器突然拉不到包。
