如何使用 Composer 来搭建一个基于微服务架构的 PHP 系统？

Composer 是 PHP 依赖管理工具，非微服务框架；它仅负责各服务内部依赖安装与版本管理，需按服务粒度独立维护 composer.json、避免强耦合、用私有包共享 DTO，并在 CI/CD 中单独执行安装。

Composer 本身不是微服务框架，它只是 PHP 的依赖管理工具。搭建微服务架构的关键在于服务拆分、通信机制和部署策略，Composer 只负责每个服务内部的依赖安装与版本管理。正确使用 Composer 是微服务落地的基础支撑，而非架构实现主体。

按服务粒度独立维护 composer.json

每个微服务应是一个独立的代码仓库，拥有自己的 composer.json。避免所有服务共用一个根级依赖文件。例如：

• user-service/：只声明 symfony/http-foundation、guzzlehttp/guzzle（用于调用其他服务）等必要依赖
• order-service/：引入 ramsey/uuid、monolog/monolog，但不装用户认证相关包
• 各服务的 autoload 配置仅映射自身命名空间，如 "App\": "src/"

用 Composer 管理私有服务包（可选但推荐）

若多个服务复用通用逻辑（如共享 DTO、异常类、SDK），可将其抽成私有 Composer 包：

• 在私有 Git 仓库（如 GitLab）中创建 php-common-dto 项目，含自己的 composer.json
• 在各服务的 composer.json 中添加仓库源：
  "repositories": [{"type": "vcs", "url": "https://git.example.com/php-common-dto"}]
• 执行 composer require example/php-common-dto:^1.2 即可安装并自动加载

避免跨服务强依赖，用 API 或消息解耦

不要在 A 服务的 composer.json 中直接 require B 服务的代码库——这会制造构建和部署耦合。正确做法是：

标签： 微服务架构 php系统 php js git json composer github app 工具 gitlab sw