Composer如何拆分项目_Composer多包管理模式说明【必看】-composer-PHP中文网

composer本身没有split命令，所谓“拆分”实为git层面操作：必须用git filter-repo或git subtree导出子目录为独立仓库，并确保其composer.json含唯一name、主项目配置vcs repositories、子包打语义化标签，composer才可加载。

composer如何拆分项目_composer多包管理模式说明【必看】

Composer 本身没有 split 命令，所谓“拆分项目”不是 Composer 的职责，而是 Git 层面的事——你得先用 git filter-repo 或 git subtree 把代码从主仓库里物理导出成独立仓库，Composer 才有东西可装。

为什么 composer split 会报错或没反应

因为命令根本不存在。运行 composer split 会得到 Command "split" is not defined。Composer 是依赖加载器，不读目录结构、不改 Git 历史、不移动文件。它只认已发布的包（来自 Packagist、私有源或本地 path 仓库）。

composer require、composer update 等所有命令都只操作 composer.json 和 vendor/，不碰 Git
想把 packages/http-client 变成独立包？必须先在 Git 层完成导出，再确保新仓库有合法的 composer.json
误以为“加个 repositories 就能自动拆分”，结果是白忙活——repositories 只影响“怎么装”，不影响“怎么切”

该用 git filter-repo 还是 git subtree

优先选 git filter-repo，尤其当你要上线、做 CI、或需要干净历史时。它重写路径、保留作者和时间戳、不污染原仓库；git subtree 适合临时导出、不关心历史纯净度的场景。

Discussion Composer

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

下载

git filter-repo --subdirectory-filter packages/http-client --force：执行后当前目录只剩 http-client 内容，所有提交路径已重写为根目录，可直接推送到新远程
git subtree push --prefix=packages/http-client origin http-client：会在原仓库留下合并提交，且后续难以回滚
无论哪种，操作前必须 git clone --bare 备份原仓库——git filter-repo 会彻底重写历史，不可逆

拆完之后 Composer 怎么“认”这个新包

不是 Composer 主动“认”，是你得让它“找得到、解析得对、加载得进”。三个硬性条件缺一不可：

子包的 composer.json 必须含全局唯一 "name" 字段，如 "myorg/http-client"（不能是 "http-client" 或 "./packages/http-client"）
主项目若要试用，需在自己的 composer.json 中 repositories 显式声明该包的 Git 地址：{"type": "vcs", "url": "https://github.com/myorg/http-client"}
子包必须打带 v 前缀的语义化标签（如 v1.0.0），否则 composer require myorg/http-client:^1.0 会找不到版本

本地开发时如何避免反复 install 才能看到修改

别等发布再测。在主项目中用 path 类型仓库 + symlink，让 vendor/myorg/http-client 直接软链到本地 packages/http-client 目录。

主项目 composer.json 中加：{"type": "path", "url": "packages/http-client", "options": {"symlink": true}}
require 写 "myorg/http-client": "dev-main"（分支名要和子包实际一致）
Windows 用户注意：终端需以管理员身份运行，或已启用“开发者模式”，否则 mklink 失败，Composer 会退化为 copy 模式
改完子包代码后，不用 dump-autoload，也不用 update——只要软链建成功，立刻生效