如何将一个私有的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）放：

标签： word js git json composer app asic