non-feature分支指用于紧急修复的短期Git分支，如hotfix/urgent-db-error；Composer通过将其转换为dev-{branch-name}.x-dev格式的伪版本来识别，例如dev-hotfix/order-validation.x-dev；在composer.json中引用时需以dev-开头、保留斜杠并添加.x-dev后缀，同时确保minimum-stability为dev或配合prefer-stable:true使用，仅建议临时依赖且目标分支已推送。
在使用 Composer 管理 PHP 项目依赖时，理解如何正确约束非主干分支（如 bugfix、hotfix 分支）的版本非常重要。这些分支通常用于紧急修复或临时补丁，不属于标准的语义化版本（SemVer）流程，但 Composer 仍能识别并安装它们，前提是版本约束写法正确。
什么是 "non-feature" 分支？
在 Git 工作流中，除了 main、develop 或版本标签外，团队可能创建短期分支来修复线上问题，例如：
hotfix/urgent-db-errorbugfix/login-timeoutfix-order-calculation
这类分支不用于长期开发，也不代表功能迭代，因此被称为 "non-feature" 分支。它们通常不会被打上正式版本标签，但仍可能需要被其他项目临时引用。
Composer 如何识别分支？
Composer 基于仓库的分支和标签自动推断可用的“版本”。对于非标准分支，Composer 会将其转换为“伪版本”（pseudo-version），格式如下：
{branch-name}.x-dev
例如：
- 分支
hotfix/order-validation→hotfix/order-validation.x-dev - 分支
bugfix/session-expire→bugfix/session-expire.x-dev
注意：分支名中的特殊字符（如 /）会被保留，Composer 支持这种命名方式。
如何在 composer.json 中引用 non-feature 分支？
要在项目中依赖某个 non-feature 分支，需在 composer.json 的 require 字段中使用对应的 .x-dev 标识：
{
"require": {
"your-vendor/your-package": "dev-hotfix/order-validation.x-dev"
}
}
关键点：
- 必须以
dev-开头 - 分支名中的斜杠无需转义
- 结尾加上
.x-dev表示这是一个开发分支的最新提交
如果分支名含特殊字符导致解析问题，可考虑重命名为更简单形式（如 hotfix-order-validation），然后使用 dev-hotfix-order-validation.x-dev。
注意事项与最佳实践
虽然可以引用 non-feature 分支，但应谨慎使用，避免长期依赖。建议：
- 仅用于临时修复，上线后尽快切换回正式版本
- 不要在生产环境长期锁定 dev 分支
- 确保目标仓库已推送该分支，否则 Composer 无法找到
- 启用
minimum-stability为dev或使用prefer-stable: true控制行为
示例配置：
{
"minimum-stability": "dev",
"prefer-stable": true,
"require": {
"your-vendor/your-package": "dev-bugfix/session-expire.x-dev"
}
}
基本上就这些。只要分支存在且命名清晰，Composer 能准确解析并安装对应代码。关键是理解 .x-dev 的映射规则，并合理控制依赖范围。
