如何将一个私有的Mercurial (Hg)仓库作为Composer源？（VCS仓库配置）

可直接在composer.json中通过"type": "hg"配置私有Mercurial仓库，需确保本地安装hg、网络可达且凭据正确（推荐用auth.json管理），Composer会自动识别标签和分支生成版本号。

可以直接把私有 Mercurial 仓库加进 composer.json 的 repositories 里，但需要确保 Composer 能访问并克隆它——关键在于配置正确的 VCS 类型和可访问的 URL。

1. 在 composer.json 中声明 Hg 仓库

Mercurial 是 Composer 原生支持的 VCS 类型之一（和 git、svn 并列），只需指定 "type": "hg" 和仓库地址：

{     "repositories": [         {             "type": "hg",             "url": "https://your-server.com/hg/your-private-package"         }     ],     "require": {         "your-vendor/your-private-package": "dev-default"     } }

注意：dev-default 表示默认分支（通常是 default），也可用具体标签如 1.0.0 或带 dev- 前缀的命名分支（如 dev-feature/login）。

2. 确保本地能克隆该仓库

Composer 内部调用 hg clone，所以执行 composer install/update 的机器必须：

• 已安装 hg 命令（Mercurial 客户端）且在 $PATH 中
• 能通过 URL 访问仓库（HTTP(S) 需带认证，ssh 需配好密钥）
• 如果是 https 私库，推荐用 https://user:Token@... 形式嵌入凭据（如 Bitbucket Cloud 支持 app Password），或配置 auth.json

3. 使用 auth.json 管理凭据（推荐）

避免把密码写进 composer.json，在项目根目录或 Composer 全局配置目录（如 ~/.composer/auth.json）放：

BrandCrowd

一个在线Logo免费设计生成器

200

查看详情

{     "http-basic": {         "your-server.com": {             "username": "your-username",             "password": "your-app-token-or-password"         }     } }

这样 Composer 会自动在 HTTP 请求中带上 Basic Auth 头，适用于 Bitbucket Server、RhodeCode、自建 Kallithea 等支持 HTTP Basic 的 Hg 服务。

4. 注意分支与版本映射规则

Composer 会扫描 Hg 仓库的标签（hg tags）和分支（hg branches）来生成版本号：

• 标签 v1.2.3 或 1.2.3 → 版本 1.2.3
• 分支 stable → 版本 dev-stable
• 默认分支（default）→ 版本 dev-default
• 未打标签的提交，只能用 dev-default#abc123 指定具体变更集

建议在私有包中规范打语义化标签（如 1.0.0），方便 require 时直接写稳定版本号。

基本上就这些。只要 hg 可用、网络通、凭据对，Composer 就能像拉 Git 包一样拉你的 Hg 包——不需要额外插件或包装器。