本地开发的Composer包如何指定特定标签版本安装？

问题描述 #

我正在本地为Laravel项目开发一个包，同时搭建了一个Laravel应用用于手动测试该包。我的包位于/home/me/packages/me/my-package，对应的Git提交已打上0.1标签。

我希望能在不同项目中切换并使用指定版本，但遇到了问题：

1. 第一种尝试：在主应用的composer.json中按如下方式引入该包：

...
"require" : {
    "me/my-package" : "0.1"
}
...

"repositories" : [
    {
        "type": "path",
        "url": "/home/me/packages/me/my-package"
    }
]

执行Composer命令后报错：

Problem 1
    - Root composer.json requires me/my-package 0.1, found me/my-package[dev-main] but it does not match the constraint.

2. 第二种尝试：使用dev-main#0.1的格式：

"require" : {
    "me/my-package" : "dev-main#0.1"
}

这种方式安装无报错，但执行$ composer show | grep me/my-package后显示：

me/my-package dev-main     My Package

显示的版本还是dev-main，而非指定的0.1标签版本。

解决方案 #

核心原因 #

使用path类型的仓库时，Composer默认会直接映射本地目录的当前分支状态，不会自动识别Git标签。要让Composer识别本地包的标签版本，需要调整仓库配置或改用Git仓库方式引用本地包。

方法一：修改path仓库配置，强制指定版本 #

在repositories中给path仓库添加options，手动绑定版本号：

"repositories" : [
    {
        "type": "path",
        "url": "/home/me/packages/me/my-package",
        "options": {
            "symlink": true, // 开发时推荐开启软链，修改包代码无需重新安装
            "versions": {
                "me/my-package": "0.1"
            }
        }
    }
]

然后在require中直接指定版本：

"require" : {
    "me/my-package" : "0.1"
}

执行composer update me/my-package后，composer show会正确显示版本为0.1。

方法二：将本地包作为Git仓库引用 #

如果希望严格遵循Git版本管理，直接引用本地Git仓库：

"repositories" : [
    {
        "type": "git",
        "url": "/home/me/packages/me/my-package"
    }
]

然后在require中直接指定标签版本：

"require" : {
    "me/my-package" : "0.1"
}

这种方式下，Composer会从本地Git仓库拉取0.1标签对应的代码，composer show也会准确显示版本号。

方法三：临时切换本地包分支到对应标签 #

如果只是单项目临时测试特定标签，可直接在本地包目录执行：

git checkout 0.1

再使用最初的path仓库配置即可，但这种方式无法在多个项目中同时使用不同版本，仅适合临时场景。

内容的提问来源于stack exchange，提问作者Zakalwe