Composer如何处理版本别名_Composer branch alias配置规则【核心】-composer-PHP中文网

composer 的 version alias 是让真实版本“冒充”合法版本号参与依赖解析，必须用 as 语法在 require 或 repositories.package 中显式声明，如 "monolog/monolog": "dev-main as 2.0.0"，且仅影响版本解析，不改变包名、路径或自动加载。

composer如何处理版本别名_composer branch alias配置规则【核心】

Composer 的 version alias（版本别名）不是给包起新名字，而是让某个真实版本“冒充”另一个合法版本号参与依赖解析——它只在 require 行或 repositories.package 定义中生效，且必须用 as 语法显式声明。

require 中写 `dev-main as 2.0.0` 才有效

你在项目 composer.json 的 require 字段里直接写 "monolog/monolog": "dev-main as 2.0.0"，Composer 才会把 dev-main 分支当作 2.0.0 来解析依赖、校验约束、写入 composer.lock。

as 左侧必须是真实可访问的源：比如 dev-main、dev-fix-log、v5.4.42（注意带 v 前缀），不能是 master 或 latest
as 右侧必须是合法版本字符串：如 2.0.0、^2.0、2.0.x-dev，但不能是 stable 或 dev-master
写成 "monolog/monolog": "2.0.0 as 3.0.0" 会报错：Invalid version string —— as 左边不能是稳定版标签
执行后必须运行 composer update monolog/monolog，仅 composer install 不会重新解析别名

`extra.branch-alias` 是包作者的事，不是你项目里的配置项

如果你在自己项目的 composer.json 里加 "extra": { "branch-alias": { "dev-main": "1.0.x-dev" } }，这完全无效。这个字段只对被 require 的**目标包自身**的 composer.json 有意义，且仅在 VCS 类型仓库（如 GitHub）中生效。

Discussion Composer

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

下载

它让别人能用 "your-vendor/your-pkg": "^1.0" 拉到你的 dev-main 分支，前提是该包已 push 到远程并被 Packagist 索引
值必须以 -dev 结尾，如 1.0.x-dev；写成 1.0.x 或 1.0-dev 都不生效
分支名必须带 dev- 前缀，哪怕 Git 里叫 main，这里也得写 "dev-main"
运行 composer show your-vendor/your-pkg，如果输出里没出现 1.0.x-dev，说明 alias 没被读取（常见于未 push 或 Packagist 缓存未更新）

想共存两个同名包？必须用 `repositories` + `type: package`

当你要同时使用官方 monolog/monolog 和某 fork 版本，又不能删掉旧包时，唯一可靠方式是：在项目 composer.json 的 repositories 里定义一个 type: package 条目，把 fork 映射为**同一个 name**，但指定不同 version 和 dist.url。