使用 Composer 的 path 仓库可实现本地包实时共享,需配置相对路径、启用 symlink 并统一用 "@dev" 版本约束,但仅限开发阶段,上线前须替换为已发布包。

直接用 type: "path" 仓库,配合相对路径和符号链接,就能让多个项目共享同一份本地包代码,改完即生效,不用重复 composer update。
path仓库配置必须写相对路径,不能用绝对路径或环境变量
Composer 的 repositories 里 url 字段只接受从当前 composer.json 所在位置出发的相对路径。比如主项目在 /srv/app,本地包在 /srv/my-utils,那 url 必须写成 "../my-utils",而不是 "/srv/my-utils" 或 "$HOME/my-utils"。
-
name字段必须和本地包composer.json中的name完全一致(包括大小写和斜杠方向) - 本地包目录下必须存在合法的
composer.json,哪怕只有{"name": "acme/utils", "autoload": {"psr-4": {"Acme\": "src/"}}} - Git 未初始化或没提交会导致 symlink 失败并静默 fallback 到复制模式——建议本地包至少执行一次
git init && git add . && git commit -m "init"
默认是复制不是软链,启用 symlink 要么配 options,要么全局设
很多人发现改了本地包代码,项目里却没更新,就是因为 path 类型默认行为是把整个目录「复制」进 vendor/,而不是建符号链接。要启用实时联动,得显式开启 symlink:
- 在主项目
composer.json的repositories条目里加"options": {"symlink": true} - 或者全局配置一次:
composer config --global path.repo.symlink true,之后所有path仓库都默认走 symlink - 注意:symlink 只在
composer install或composer update时创建,改完配置后必须重装依赖才生效
多项目共用一个本地包时,require 版本号建议用 @dev
如果多个项目都 require 同一个本地包,又不想每次切分支都去改各自的 composer.json,就别写死 "dev-main" 或 "1.2.0",统一用 "@dev":
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
-
"acme/utils": "@dev"会强制 Composer 从path源拉取,跳过 Packagist 查询 - 不依赖本地包
composer.json里的version字段,也无需打 tag - 只要本地包有 Git,
git checkout feat/auth后,所有引用它的项目立刻加载新分支代码 - 但要注意:CI 环境若没 Git 或没检出历史,
@dev可能失败,生产部署应换回稳定版本约束
别指望 vendor-dir 分离或多路径共存来“隔离版本”
有人想让 Laravel 9 和 10 项目分别引用同一本地包的不同分支,并通过改 config.vendor-dir 实现物理隔离——这行不通。Composer 不支持多 vendor 目录,自动加载器、bin 脚本、依赖解析全部基于单一 vendor/ 结构。
-
config.vendor-dir是字符串,不是数组,也不能条件化 - 真要测试多版本兼容性,正确做法是建多个独立项目目录,各自配自己的
path仓库 +@dev,互不干扰 - 或者用
git submodule把本地包嵌入各项目,靠子模块 commit hash 控制版本
最易被忽略的一点:path 仓库只在开发阶段高效,上线前务必确认该包已发布到私有 Packagist 或 Git 仓库,并把 repositories 配置移除——否则生产环境一旦断网或路径失效,composer install 会直接失败。










