Composer配置镜像有全局、项目级和临时三种方式：全局用composer config -g repo.packagist composer URL，项目级在composer.json中添加repositories字段，临时用--repository-url参数；项目级优先级高于全局，临时最高。

Composer配置自定义Packagist镜像的两种方式

直接改全局配置或项目级配置都能生效，但优先级不同：项目根目录下的 composer.json 里的设置会覆盖全局 config.json 中同名配置。生产环境建议用项目级配置，避免污染其他项目。

• 全局镜像（影响所有项目）：编辑 ~/.composer/config.json（Linux/macOS）或 %APPDATA%\Composer\config.json（Windows）
• 项目镜像（仅当前项目）：在项目根目录的 composer.json 中添加 repositories 字段
• 临时生效（单次命令）：加 --repository-url=https://mirrors.example.com 参数，不写入配置

使用 repositories 配置自定义Packagist镜像

这不是简单替换URL，而是把镜像声明为一个类型为 composer 的仓库。Packagist官方镜像本身也是以这种形式注册的，所以自定义镜像必须保持结构兼容。

Discussion Composer

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

下载

• 必须指定 "type": "composer"，不能是 "package" 或 "vcs"
• "url" 值应指向镜像的 packages.json 入口（如 https://mirrors.huaweicloud.com/php/composer/），不是单纯首页
• 如果镜像支持完整 Packagist 协议（含 provider-includes 和 providers），可加 "packagist.org": false 关闭默认源
• 示例片段：

{
    "repositories": [
        {
            "type": "composer",
            "url": "https://mirrors.huaweicloud.com/php/composer/"
        },
        {
            "packagist.org": false
        }
    ]
}

验证镜像是否生效及常见失败原因

执行 composer diagnose 只能检查配置语法，不能确认镜像连通性；真正验证得看 composer show -p 或 composer require 是否从预期域名发起请求。

• 错误现象：Could not fetch https://packagist.org/packages.json —— 说明 "packagist.org": false 没配，或 repositories 顺序错（Packagist 默认源仍被启用）
• 错误现象：file could not be downloaded: failed to open stream: Connection refused —— 镜像URL不可达，或该镜像未同步最新元数据
• 错误现象：Package xxx not found —— 镜像未包含该包，或包名大小写/版本约束与镜像索引不匹配（有些镜像不同步 dev 分支）
• 调试建议：加 -vvv 参数运行 composer update，观察实际 HTTP 请求的 Host 和路径

国内常用镜像的URL和注意事项

华为云、阿里云、腾讯云等镜像大多兼容 Packagist v2 协议，但同步延迟和包覆盖范围有差异。清华源已停止维护 Composer 镜像，当前不推荐使用。

• 华为云：https://mirrors.huaweicloud.com/php/composer/（需注意末尾斜杠不能省）
• 阿里云：https://mirrors.aliyun.com/composer/（稳定，同步延迟通常
• 腾讯云：https://mirrors.cloud.tencent.com/composer/（部分区域 DNS 解析可能不稳定）
• ⚠️ 所有镜像都不代理私有包（private 类型仓库），若项目依赖私有 Git 仓库，仍需单独配置 vcs 类型 repositories

镜像配置本身不难，真正容易卡住的是网络可达性判断和协议兼容性——比如有些企业内网镜像只实现了基础 packages.json 返回，却不支持 provider-includes 动态加载，这时候就得降级到全量索引模式或换镜像。