构建模块化系统：利用Composer管理多包仓库与微服务架构-composer-PHP中文网

composer不支持原生多包仓库，需通过repositories显式配置vcs或path类型源引入包；私有git包须用https url加auth.json认证，本地path包需@dev版本约束并执行composer update --with-dependencies同步代码。

构建模块化系统：利用composer管理多包仓库与微服务架构

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 Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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 规则覆盖