Composer本地包如何配置版本约束-composer-PHP中文网

本地包版本约束必须显式声明为path类型，需在repositories中注册type为path的仓库，url为相对或绝对路径，require中只能用"*"，其他语义化版本符无效，实际版本由本地包composer.json的version字段决定。

composer本地包如何配置版本约束

本地包的版本约束必须显式声明为 path 类型

Composer 默认不识别本地文件路径作为包源，直接写 "vendor/package": "1.2.3" 会报 Could not find package。你得先在 composer.json 的 repositories 里注册一个 path 类型仓库，否则任何版本约束都无效。

正确配置示例：

{
    "repositories": [
        {
            "type": "path",
            "url": "./packages/my-local-package"
        }
    ],
    "require": {
        "my-vendor/my-local-package": "*"
    }
}

关键点：

url 必须是相对于项目根目录的**绝对路径或相对路径**，不能是 URL 或 git 地址
type 必须为 path，不是 package 或 vcs
本地包目录下必须有合法的 composer.json，且其中 name 字段要和 require 中一致
"*" 是唯一推荐的约束写法——它会读取本地包 composer.json 里的 version 字段，而不是去 Packagist 查

本地包不能用 ^、~、= 等语义化约束符

如果你对本地包写 "my-vendor/my-local-package": "^1.2.0"，Composer 会忽略该约束，仍按本地 composer.json 中的 version 值安装，并可能报 warning：Skipped tag v1.2.0, no composer.json found（如果本地没打 Git tag）。

原因在于：path 类型仓库不参与语义化版本解析，它只做“软链接式”挂载。所有 ^、~、=、@stable 都会被跳过。

所以：

别写 ^1.2.0、~1.2、=1.2.3 —— 它们不起作用，还可能误导后续维护者
也别写 dev-main 或 1.2.3@stable —— path 不支持分支或稳定性标记
想“锁定”本地包内容，靠的是 Git commit hash 或文件系统状态，不是版本字符串

本地包的 version 字段决定实际加载行为

Composer 读取本地包时，真正起作用的是其内部 composer.json 中的 version 字段。这个值会覆盖你在主项目中写的任何约束（哪怕你写了 "*"）。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

比如本地包 ./packages/foo/composer.json 写着：

{
    "name": "acme/foo",
    "version": "dev-main"
}

那么无论主项目写 "acme/foo": "*" 还是 "acme/foo": "1.0.0"，最终装进去的都是 dev-main 快照。

常见陷阱：

本地包没写 version 字段 → Composer 报错 Package acme/foo has no version set
本地包写了 "version": "1.2.3"，但你改了代码没更新字段 → composer install 不会重装，缓存命中后内容不一致
本地包 version 是 dev-main，而主项目 minimum-stability 是 stable → 装不上，需加 --stability=dev 或临时调低全局稳定性