可通过在require中使用dev-前缀指定Git分支安装开发包,如"dev-develop";2. 需在repositories中声明自定义Git仓库地址;3. 支持结合稳定性标记或提交哈希锁定版本;4. 注意分支存在性、认证配置及生产环境慎用dev分支。

要在 Composer 中安装一个指定 Git 分支的开发包,你可以直接在 composer.json 的 require 字段中使用分支名称,并加上 dev- 前缀。Composer 会从对应的 Git 仓库拉取该分支的最新代码。
1. 指定 Git 分支安装
假设你想从 GitHub 安装某个项目(例如 monolog)的 develop 分支,可以在 composer.json 中这样写:
{
"require": {
"sentry/sentry": "dev-develop"
},
"repositories": [
{
"type": "git",
"url": "https://github.com/getsentry/sentry-php.git"
}
]
}
执行 composer install 或 composer update 后,Composer 会克隆该仓库并检出 develop 分支。
2. 使用版本约束语法
如果你只想锁定到某个分支的特定提交或允许更新,可以结合稳定性标记:
- dev-develop:使用 develop 分支,允许更新
- dev-feature/new-api as 1.0.0:将一个功能分支伪造成某个稳定版本号
- dev-master#commit-hash:锁定到某一分支的特定提交(不推荐长期使用)
3. 添加自定义仓库(非 Packagist)
如果包不在 Packagist 上,必须先在 repositories 中声明 Git 地址:
"repositories": [
{
"type": "git",
"url": "https://gitee.com/your-company/custom-package.git"
}
]
然后就可以像上面一样使用 dev-branch-name 来引用。
4. 注意事项
- 确保远程分支存在且可访问
- 私有仓库需配置 SSH 或 token 认证
- 开发分支不会自动触发更新,除非运行 composer update
- 生产环境慎用 dev 分支,建议打 tag 并使用稳定版本










