Composer不支持原生多包仓库，需通过repositories显式配置vcs或path类型源引入包；私有Git包须用HTTPS URL加auth.json认证，本地path包需@dev版本约束并执行composer update --with-dependencies同步代码。
Composer 本身不支持“多包仓库”这个概念——它只认一个 composer.json，也只装一个项目的依赖。所谓“多包管理”，本质是靠 repositories 配置把多个独立包（无论远程还是本地）显式引入主项目，再由 Composer 统一解析依赖图。没配对 repositories，包就不存在；配错路径或认证，composer require 就会报 Could not find package。
私有 Git 包怎么让 Composer 认出来
默认情况下，Composer 只查 Packagist。要拉公司内网 GitLab 上的 acme/user-service，必须在根项目的 composer.json 里加 repositories 块：
{
"repositories": [
{
"type": "vcs",
"url": "https://gitlab.example.com/php/user-service.git"
}
]
}
关键点：
- 必须用 HTTPS URL，别写
git@gitlab...—— CI 环境通常没 SSH key，会卡在克隆阶段 - Git 认证不能靠
~/.gitconfig，得靠项目根目录下的auth.json -
auth.json内容必须严格匹配域名，比如{"http-basic": {"gitlab.example.com": {"username": "token", "password": "PAT_abc123"}}} - 执行
composer require acme/user-service:dev-main时，版本号必须带分支或别名（如dev-main、1.0.x-dev），否则 Composer 不知道该取哪份代码
本地开发多个包，怎么实时联动更新
你有 module-a 和 module-b 两个本地目录，每个都有自己的 composer.json，想改完 module-a 的代码立刻被 module-b 感知到，不能每次改完都 composer update。
正确做法是用 path 类型仓库：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
{
"repositories": [
{
"type": "path",
"url": "./module-a"
}
],
"require": {
"acme/module-a": "*@dev"
}
}
注意：
-
url是相对路径，指向含composer.json的目录，不是文件 -
require中的版本必须写*@dev，否则 Composer 会去 Packagist 找，而不是走本地路径 - 改了
module-a的autoload或类结构后，必须运行composer dump-autoload，否则自动加载映射不会更新 -
composer update acme/module-a --with-dependencies才会真正同步代码变更；只跑composer update可能跳过
微服务之间共享 domain 模型，怎么避免 autoload 错误
多个微服务（如订单服务、支付服务）都依赖同一个 acme/domain-models 包，但一跑就报 Class not found，大概率是 autoload 配置没对齐。
检查三处：
- 共享包自身的
composer.json必须有正确的autoload，比如："psr-4": {"Acme\Domain\": "src/"} - 每个微服务的
composer.json在require进该包后，要执行composer install（不是dump-autoload），否则 vendor 里没生成对应加载逻辑 - 微服务代码中
require __DIR__.'/vendor/autoload.php';必须在最开始执行，且不能被条件逻辑跳过 - 如果共享包用了
files类型 autoload（比如全局函数），要确认它没被其他包的 autoload 规则覆盖
最常被忽略的一点：所有微服务和共享包的 autoload 命名空间前缀必须一致，且不能出现同名但路径不同的映射——Composer 不会报错，但运行时类只会从第一个匹配的路径加载，后面那个等于白写。
