Composer中文镜像环境下如何强制指定依赖安装源-composer-PHP中文网

必须带type参数，正确命令为composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，漏掉中间composer会导致静默回退至官方源；还需确保url以/结尾、键名无误，且项目级repositories会完全屏蔽全局配置。

composer中文镜像环境下如何强制指定依赖安装源

composer config -g repo.packagist 必须带 type 参数

不写 composer 这个 type 值，全局镜像配置就等于没设。命令形如 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，其中第二个 composer 是仓库类型，不是命令名，也不是可选注释。漏掉它，Composer 2.0+ 会静默 fallback 到 https://packagist.org，composer config -g repo.packagist 看起来有输出，但实际请求仍走官方源。

验证是否生效：运行 composer config -g repo.packagist，应输出类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。返回空、null 或报错，说明配置失败。

项目级 repositories 会彻底屏蔽全局镜像

只要 composer.json 里存在 repositories 字段（哪怕只有一行 "packagist.org": false），全局配置就完全失效——这不是“优先级低”，而是直接跳过。

常见于 Laravel 脚手架或团队模板，默认带空 repositories 块。验证方式：进项目目录后运行 composer config repo.packagist（不加 -g），如果输出为空或报错，说明项目配置已接管。

临时绕过：用 --repository-url 强制当次命令走镜像，例如 composer install --repository-url=https://mirrors.ustc.edu.cn/composer/
永久修复：删掉 composer.json 中整个 repositories 块；或改用 composer config repo.packagist composer https://mirrors.aliyun.com/composer/ 覆盖写入（注意：该命令会重写整个 repositories 对象，私有源需手动保留）

用 package 类型仓库强制指定单个包来源

当需要绕过镜像、私有 fork 或内网部署时，repositories 中的 package 类型提供终极控制权：手动声明包名、版本、dist/source 地址，完全脱离 Packagist。

示例：强制使用某 fork 的 monolog/monolog 特定 commit：

Discussion Composer

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

下载

{
    "repositories": [
        {
            "type": "package",
            "package": {
                "name": "monolog/monolog",
                "version": "dev-main",
                "dist": {
                    "url": "https://example.com/monolog-2.x.zip",
                    "type": "zip"
                }
            }
        }
    ],
    "require": {
        "monolog/monolog": "dev-main"
    }
}

关键点：

dist 优先于 source 下载，失败时才回退
必须确保 require 中的版本号与 package 声明的 version 完全匹配（包括 dev- 前缀）
同一包不能在多个仓库中重复定义，否则 Composer 会报 Package X is already defined

换源后不清理缓存 = 白配

Composer 缓存的是元数据快照（如 p2/monolog/monolog.json），旧缓存里存的仍是官方源地址和 hash。即使镜像已生效，composer update 仍可能因校验失败报 Package not found 或卡在 Loading composer repositories。

必须执行 composer clear-cache，并确认：

Linux/macOS：~/.composer/cache/ 下无有效文件
Windows：%APPDATA%\Composer\Cache\ 已清空

验证是否真走镜像：加 -vvv 参数跑一次安装，看到类似 GET https://mirrors.aliyun.com/composer/p2/monolog/monolog.json 的日志才算成功。

CI/CD 或宝塔环境里 -g 配置常不生效——全局配置写在 ~/.composer/config.json，但“谁在跑命令”决定读哪个路径。宝塔后台以 www 用户运行，CI 构建容器常用 runner 用户，而你本地终端可能是 root 或普通用户。三者 ~ 指向不同目录，配置互不可见。