合理组织目录结构并配置各子项目依赖，通过path类型仓库实现本地包共享，每个子应用独立维护composer.json，根目录可选统一管理开发工具。
在 Monorepo 项目中使用 Composer 管理多个子应用，核心在于合理组织目录结构并配置好每个子项目的依赖关系。Composer 本身不直接支持 Monorepo 模式，但通过灵活的配置可以实现高效管理。
合理规划目录结构
将每个子应用视为独立的包或项目，放在统一的根目录下。例如：
/monorepo-root ├── composer.json # 根级 composer.json（可选） ├── apps/ │ ├── frontend-app/ │ │ └── composer.json │ ├── backend-api/ │ │ └── composer.json │ └── admin-panel/ │ └── composer.json ├── packages/ │ └── shared-utils/ │ └── composer.json └── vendor/ # 全局或各应用各自的 vendor 目录
apps/ 存放可独立运行的应用，packages/ 存放可复用的私有库。这样结构清晰，便于维护。
配置子应用的 composer.json
每个子应用都应有自己的 composer.json，明确声明其依赖和自动加载规则。
- 设置正确的 type，如 library、project 等
- 定义 autoload 规则，如 psr-4 映射命名空间
- 在 require 或 require-dev 中列出所需依赖
例如 backend-api/composer.json：
{
"name": "mycompany/backend-api",
"type": "project",
"require": {
"php": "^8.1",
"slim/slim": "^4.0"
},
"autoload": {
"psr-4": {
"App\\Backend\\": "src/"
}
}
}
本地共享包的路径映射
如果多个子应用依赖同一个本地包（如 shared-utils），可通过 path 类型仓库引入。
在子应用的 composer.json 中添加：
{
"repositories": [
{
"type": "path",
"url": "../packages/shared-utils"
}
],
"require": {
"mycompany/shared-utils": "*"
}
}
这样 Composer 会软链接（或复制）该包到 vendor，开发时修改即时生效。部署时建议打包发布到私有 Packagist 服务以避免路径问题。
根目录统一管理（可选）
可在根目录放置一个 composer.json 用于集中执行通用命令或安装开发工具。
例如安装 PHPStan、PHPUnit 等全局开发依赖：
{
"require-dev": {
"phpunit/phpunit": "^10",
"phpstan/phpstan": "^1.0"
},
"config": {
"allow-plugins": {
"composer/package-versions-deprecated": true
}
}
}
这类工具可在各个子项目中通过 ./vendor/bin/ 调用，无需重复安装。
基本上就这些。关键点是保持每个子项目独立可运行，通过 path 仓库实现本地依赖共享，结构清晰就能避免混乱。
