Composer怎么配置仓库来源_Composer如何在composer.json中添加自定义repositories【基础】-composer-PHP中文网

最常见原因是 repositories 未置于根级：必须与 require 平级，不可放在 require-dev 或包配置内；composer 仅识别顶层 repositories 数组，且默认禁用 packagist.org，需手动添加 type composer 的官方源。

composer怎么配置仓库来源_composer如何在composer.json中添加自定义repositories【基础】

为什么 `composer.json` 里的 `repositories` 不生效

最常见原因是配置位置不对：必须把 repositories 放在根级（和 require 同级），而不是塞进 require-dev 或某个包的配置里。Composer 只认顶层的 repositories 数组，且默认会禁用 packagist.org 的全局镜像（除非显式启用）。

典型错误写法：

{
  "require": { "monolog/monolog": "^2.0" },
  "require-dev": {
    "repositories": [ ... ]  ← 这里完全被忽略
  }
}

正确结构要点：

repositories 必须是根级字段，和 name、require 并列
如果想保留 Packagist 官方源，得手动加一条 type composer 的记录指向 https://packagist.org
多个仓库按数组顺序查找，靠前的优先匹配 —— 所以私有包仓库建议放前面

怎么添加 Git 仓库作为自定义 source

适用于你有私有 Git 项目（如公司内部组件），又不想发到 Packagist 的场景。关键是设对 type 和 url，且目标仓库必须含合法的 composer.json。

示例（GitHub 私有库）：

{
  "repositories": [
    {
      "type": "vcs",
      "url": "https://github.com/your-org/internal-sdk"
    }
  ],
  "require": {
    "your-org/internal-sdk": "dev-main"
  }
}

注意点：

type 填 vcs（不是 git），Composer 才能自动识别 Git/SVN/Hg
分支名要写成 dev-xxx 格式（如 dev-main、dev-feature/auth），否则 Composer 找不到
如果仓库没打 tag，就只能用 dev- 前缀引用分支；打了 tag 才能写 1.2.0 这样的稳定版本
HTTPS 地址需配好 Git 凭据或用 SSH（git@github.com:...），否则 composer install 会卡住

如何用 `package` 类型硬编码一个不存在的包

当你要临时覆盖某个包的行为，或者集成一个根本没有 composer.json 的 ZIP 库时，就得用 type: "package" 手动声明元数据。

Discussion Composer

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

下载

示例（引入一个纯 ZIP 的 SDK）：

{
  "repositories": [
    {
      "type": "package",
      "package": {
        "name": "acme/legacy-sdk",
        "version": "1.0.0",
        "dist": {
          "url": "https://example.com/sdk-1.0.0.zip",
          "type": "zip"
        },
        "autoload": {
          "psr-4": { "Acme\Sdk\": "src/" }
        }
      }
    }
  ],
  "require": {
    "acme/legacy-sdk": "1.0.0"
  }
}

关键限制：

package 类型不支持自动更新 —— 每次改内容都得手动改 version 字段再 composer update
dist.url 必须可直接下载，且解压后结构要和 autoload 路径匹配
不能混用 vcs 和 package 声明同一个 name，否则 Composer 会报错

国内用户绕不开的镜像配置陷阱

很多人以为加个阿里云镜像地址就能加速所有包，但其实 repositories 里只填镜像 URL 是无效的 —— 镜像服务本身仍是 type: "composer" 类型，且必须包含完整元数据接口。

正确写法（阿里云镜像）：

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

但要注意：