如何在Composer中管理多应用共享代码？父子项目结构配置-composer-PHP中文网

每个应用必须拥有独立的 composer.json 和 vendor 目录，共享会导致类加载错误；安全复用代码需用 type: "path" 仓库，开发后须切换为 vcs 仓库；多租户需动态生成独立 composer.json 并严格控制 autoload 加载顺序。

如何在composer中管理多应用共享代码？父子项目结构配置

多应用不能共用 vendor 或 composer.json，这是确定性错误源

试图让多个应用共享同一个 vendor/ 目录，或把所有 composer.json 合并到一个根目录下，必然导致 Class not found、autoload.php 路径错乱、Method does not exist 等问题。这不是配置没调好，而是 Composer 的设计前提被破坏了——每个项目必须有自己独立的 composer.json 和生成的 vendor/autoload.php，后者硬编码了当前项目的 PSR-4 映射和类路径。

常见翻车点：

把 composer.json 放在 apps/ 子目录里，然后在父目录运行 composer install → 找不到文件或生成错位的 vendor/
用软链接把 A 项目的 vendor/ 挂给 B 项目用 → App\ 命名空间映射指向 A 的 src/，B 项目根本找不到自己的类
在 CI 中删掉 vendor/ 却没提交 composer.lock → 构建时版本漂移，环境不一致

共享代码唯一安全方式：path 仓库 + 独立子包

本地开发阶段，让多个应用实时复用同一套 SDK 或基础组件，必须走 "type": "path" 仓库路线。这不是“技巧”，是 Composer 官方唯一支持且不破坏隔离性的方案。

实操要点：

共享代码（如 acme/sdk）必须是独立目录，内含合法 composer.json，name 字段严格为全限定格式（如 "acme/sdk"），autoload 配置 PSR-4 与命名空间完全匹配

主应用的 composer.json 中添加：

{
  "repositories": [
    {
      "type": "path",
      "url": "../acme-sdk"
    }
  ],
  "require": {
    "acme/sdk": "dev-main"
  }
}

url 必须是相对于当前项目根目录的相对路径，不能跨出项目边界（比如 ../../shared 会触发 composer validate 报错）
安装后默认创建符号链接，改源码立即生效；Windows 下需确认开发者模式已启用，否则要显式加 "options": {"symlink": false} 避免静默失败

生产环境必须替换 path 为 Git 或私有 Packagist

"type": "path" 只能出现在开发阶段的 composer.json 中，上线前必须删除或替换。否则部署时会因路径不存在而报 Could not find package，且无法通过镜像加速或权限控制。

Discussion Composer

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

下载

切换步骤：

将共享代码推送到 Git 仓库（如 https://git.example.com/acme/sdk.git），确保根目录有 composer.json，且打过语义化 tag（如 v1.2.0）

主应用中把 repositories 改为：

{
  "type": "vcs",
  "url": "https://git.example.com/acme/sdk.git"
}

把 require 中的 "acme/sdk": "dev-main" 改为具体版本约束，如 "acme/sdk": "^1.2"
执行 composer clear-cache，再 composer update acme/sdk --no-cache 强制刷新元数据

多租户/子应用需动态生成独立 composer.json

当不同租户或微服务模块需要不同版本的同一依赖（比如一个要 guzzlehttp/guzzle:^6.5，另一个要 ^7.5），你无法靠配置绕过 Composer 的单解限制。每个租户目录（如 tenants/a/）下必须放独立 composer.json。

关键约束：

动态生成时只允许 name、require、autoload 字段可变，其他字段（如 type、license）应固化
require 中的包名必须校验白名单，版本约束必须符合语义化（拒绝 1.*.* 或 dev-main）
安装命令必须带 -d 指定目录，且禁用脚本：composer install --no-scripts --no-interaction -d tenants/a
运行时不能 require vendor/autoload.php，而要显式 include_once 'tenants/a/vendor/autoload.php'，注意 ClassLoader 注册顺序（先租户后主项目）