Composer国内镜像加速实战案例-composer-PHP中文网

镜像配置不生效主因是命令错误：键名必须为repo.packagist（单数）、type值必填composer、url须https且末尾带/，三者缺一即静默回退官方源；验证需输出完整json，空/null或仅url均失败。

composer国内镜像加速实战案例

镜像配置不生效，90% 是命令写错了，不是网络问题。 你执行 composer config -g repo.packagist 后 composer install 还是慢，大概率没配对——它不报错，但会静默 fallback 到 https://packagist.org。

为什么 `composer config -g repo.packagist` 总是不生效

这条命令有三个硬性条件，缺一不可：

repo.packagist 是唯一合法键名，写成 repos.packagist、Repo.Packagist 或 packagist.org 都无效
中间的 composer 是 type 值，不是注释或可选参数；漏掉它，Composer 2.2+ 会直接忽略整条配置
URL 必须是 https:// 开头，且末尾带且仅带一个 /，例如 https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠）或 http://❌（HTTP 被默认拒绝）

验证是否成功：运行 composer config -g repo.packagist，输出必须是完整 JSON 对象，形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。如果返回空、null、报错，或只显示 URL 字符串（新版行为），说明根本没写进去。

项目级配置比全局更可靠，但别覆盖已有私有源

全局配置在宝塔、CI、Docker 或多用户系统中常失效——因为 composer config -g 写的是当前用户的 ~/.composer/config.json，而实际执行命令的可能是 www、jenkins 或 root 用户。

推荐在项目根目录（含 composer.json）执行：

composer config repo.packagist composer https://mirrors.aliyun.com/composer/

注意：不加 -g。这条命令会自动修改 composer.json 的 repositories 字段：

Discussion Composer

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

下载

若原 "repositories": {}（对象），它会转为数组并插入 packagist 条目
若原 "repositories": []（数组），它会在末尾追加，不破坏已有 Git/Satis 源
但如果你手动编辑过 repositories，且里面已有私有源，**别用这条命令**——它会全量替换，清空你所有自定义源

此时应手动添加：

"repositories": [
  {
    "type": "composer",
    "url": "https://mirrors.aliyun.com/composer/"
  },
  {
    "type": "vcs",
    "url": "https://git.example.com/private/pkg"
  }
],
"packagist.org": false

注意："packagist.org": false 必须写在 composer.json 根节点，不是 repositories 里；漏掉它，私有源 + 镜像共存时可能跳过基础包校验。