Composer不是架构工具，而是依赖管理与自动加载工具；它通过path仓库+独立composer.json实现单体项目内模块物理隔离、契约通信与实时联动，避免伪单体耦合。
composer 不是用来“管理单体架构”的工具，它本身不定义架构形态，而是为任何 PHP 项目提供依赖解析与自动加载能力。所谓“用 Composer 管理单体架构”，本质是误读——你真正需要的，是在单体项目中用 Composer 实现模块化开发的组织方式，避免代码耦合、提升可维护性。
为什么不能直接“用 Composer 构建单体架构”
Composer 是包管理器，不是架构框架。它不强制目录结构、不介入运行时路由或模块通信，只做两件事：install 依赖、dump-autoload 加载类。如果你把所有业务代码都塞进 src/ 下却不划分命名空间和包边界，哪怕用了 composer require 引入外部库，项目仍是逻辑紧耦合的“伪单体”。常见错误现象包括：
- 修改用户模块时，订单测试全挂——因为
User和Order类共用同一个AppServices目录，且互相new实例 -
composer dump-autoload -o后自动加载变慢——因为 PSR-4 映射太宽泛，如"App\": "src/"导致扫描整个src/目录 - 想抽离支付模块复用到新项目，却发现它硬编码调用了
AppModelsUser，无法单独composer install
如何用 composer.json 划清模块边界
关键不在“装多少包”，而在“怎么声明包之间的契约”。真实可行的做法是：把每个业务域（如用户、订单、通知）定义为一个**本地 Composer 包**，通过 path 仓库类型引用，而非全部堆在主项目 src/ 里。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 每个模块有自己的
composer.json，例如modules/user/composer.json：{ "name": "myapp/user-module", "type": "library", "autoload": { "psr-4": { "MyApp\User\": "src/" } } } - 主项目
composer.json中添加path仓库并 require："repositories": [ { "type": "path", "url": "./modules/user" } ], "require": { "myapp/user-module": "*" } - 执行
composer update myapp/user-module，Composer 会软链接modules/user到vendor/myapp/user-module，既保持独立开发，又享受自动加载
autoload 配置里的性能陷阱
PSR-4 映射写错，轻则加载失败，重则拖垮 CLI 命令响应速度。必须注意三点：
- 路径末尾不加斜杠：
"MyApp\User\": "modules/user/src"✅；"MyApp\User\": "modules/user/src/"❌（Composer 会多拼一次/，导致文件找不到） - 命名空间末尾必须带反斜杠：
"MyApp\User\"✅；"MyApp\User"❌（否则MyAppUserContract会被映射到modules/user/src/Contract.php而非modules/user/src/Contract.php） - 避免嵌套映射冲突：若同时定义了
"MyApp\": "src/"和"MyApp\User\": "modules/user/src"，后者会被前者覆盖——Composer 按配置顺序匹配，先命中者胜
什么时候该拆成独立 git 包？
不是所有模块都需要发布到 Packagist。判断依据很实际：
- 是否被 ≥2 个项目共用？比如内部统一的短信网关 SDK、RBAC 权限组件 → 应拆为独立 git 仓库 +
packagist.org或私有 Satis 仓库 - 是否需独立版本控制？比如订单模块要按
v1.2.0发布，且主项目明确要求"myapp/order-sdk": "^1.2"→ 必须脱离主项目源码树 - 是否涉及敏感配置或密钥？如支付模块含私钥逻辑 → 绝对不可放在主项目
modules/下，必须隔离仓库 + 严格访问控制
多数团队卡在“该不该拆”的犹豫上，结果是既没获得模块化收益，又承担了单体维护成本。最务实的起点是：先用 path 本地拆分，跑通 CI/CD 和本地开发流，再根据复用频率决定是否升格为独立包。
