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

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

裘德小鎮的故事

发布： 2025-12-15 20:49:02

原创

614人浏览过

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

如何将一个私有的mercurial (hg)仓库作为composer源？（vcs仓库配置）

可以直接把私有 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 服务。