在 Monorepo 中用 Composer 管理多个 PHP 包，核心是通过配置 path 类型仓库（如 "packages/*"）将本地子包目录作为可安装源，再以 composer require acme/my-utils:dev-main 方式安装，自动生成指向源码的符号链接实现热更新。
在 Monorepo 中用 Composer 管理多个 PHP 包，核心是让本地开发包能被主项目即时识别和加载，而无需反复发布或手动拷贝。关键不是“绕过 Composer”，而是用 path 仓库类型把本地目录当作可安装的包源。
配置 path 仓库指向本地包目录
在根项目的 composer.json 中声明一个 path 类型仓库，指向你存放各子包的目录（比如 packages/*）：
- 仓库配置示例：
"repositories": [ { "type": "path", "url": "packages/*" } ] -
packages/*会匹配所有子目录（如packages/my-utils、packages/api-client），每个目录下必须有独立的composer.json，且包含合法的name（如"acme/my-utils"）和version（建议设为"dev-main"或"*@dev"） - 注意：路径支持通配符，但不递归子目录；若包在
packages/core/v2，需显式写"packages/core/v2"或调整结构
在主项目中 require 本地包
直接按正常方式 require 子包名，Composer 会自动从 path 仓库解析并软链接（symlink）到 vendor/：
- 执行：
composer require acme/my-utils:dev-main - 成功后，
vendor/acme/my-utils是指向packages/my-utils的符号链接，改代码即实时生效 - 如果子包依赖其他本地包，它们也会被一同解析和链接——前提是那些包也在
path仓库覆盖范围内
避免常见陷阱
path 仓库方便，但几个细节不注意会导致“找不到包”或“装错版本”：
-
包名必须完全匹配：子包
composer.json中的"name"必须与require时写的名称一致，大小写敏感 -
不要混用版本约束：本地开发建议统一用
"dev-main"或"*@dev"；避免写"^1.0"同时又期望加载本地代码，Composer 可能优先选 packagist 上已发布的版本 -
清理缓存再重试：改了
repositories或子包composer.json后，运行composer clear-cache再composer update，否则可能读取旧索引 - Windows 用户注意符号链接权限：默认可能禁用；需以管理员身份运行终端，或启用开发者模式，否则 symlink 创建失败，Composer 会复制而非链接
配合脚本简化日常操作
Monorepo 包多时，手动 require 易出错。可在根目录加一个简易脚本（如 bin/install-all）批量安装：
- 内容示例（bash）：
#!/usr/bin/env bash composer require \ acme/my-utils:dev-main \ acme/api-client:dev-main \ acme/config-loader:dev-main \ --no-update composer update
- 也可用
composer install替代update，前提是composer.lock已包含这些本地包的正确记录 - CI 环境中应禁用
path仓库（改用真实发布版本），避免构建依赖本地路径
基本上就这些。path 仓库不是黑魔法，它只是让 Composer 把文件系统当包源来查。只要结构清晰、命名一致、版本对齐，Monorepo 的 PHP 包协作就能既高效又可靠。
