Composer 不创建微服务，仅负责各服务内部依赖管理与自动加载；微服务拆分、通信、部署需靠目录隔离、HTTP/API、消息队列及CI/CD实现。
Composer 本身不创建微服务，它只管每个服务内部的依赖装对、类能自动加载、不越界拉其他服务的代码。 真正的微服务拆分、通信、部署，得靠目录隔离、HTTP/API 调用、消息队列和 CI/CD 编排来实现。Composer 在这里干的是“后勤”活——你拆得再细，它也只认 composer.json 里声明的那几行依赖。
每个服务必须有独立的 composer.json 和 vendor 目录
不能把所有微服务塞进一个仓库、共用一个根级 composer.json。否则：composer install 会把用户服务、订单服务、支付服务的包全装进同一个 vendor/，运行时互相污染，autoload 映射打架，Class not found 错误定位困难。
- 每个服务开独立 Git 仓库，如
user-service/、order-service/ -
user-service/composer.json只写自己需要的：比如"guzzlehttp/guzzle": "^7.0"（调其他服务）、"monolog/monolog": "^3.0"（打日志），但绝不写"order-service/*" -
autoload段只映射自身命名空间："App\": "src/"，不能跨服务映射对方路径 - CI 流水线中，必须
cd user-service && composer install --no-dev --optimize-autoloader，而不是在项目根目录跑一次全局安装
共享逻辑必须抽成私有 Composer 包，不能 require 其他服务代码库
多个服务都用同一套 DTO、异常基类、ID 生成器？别直接 composer require ../order-service/src 或硬拷文件——这等于把部署耦合写死在依赖里，一改全崩。
- 新建私有 Git 仓库，如
gitlab.example.com/php/domain-models，含自己的composer.json，声明"autoload": {"psr-4": {"Domain\": "src/"}} - 在各服务的
composer.json中加"repositories"段：{"type": "vcs", "url": "https://gitlab.example.com/php/domain-models"} - 执行
composer require example/domain-models:^2.1（带明确版本或分支名，如dev-main） - 认证走
auth.json，不用 SSH URL；路径写"src/"，别写"./src/"或"src"（少斜杠会失效）
生产环境只用 composer install，CI/CD 中禁用 composer update
composer update 是开发阶段手动行为，上线和 CI 里执行等于埋雷。它会忽略 composer.lock，按 composer.json 重算依赖树，可能把 A 服务锁在 shared-utils v2.1，B 服务悄悄升到 v3.0——接口变了、字段丢了、没报错，但数据就静默丢失了。
- 所有环境（dev/staging/prod）必须用
composer install，严格按composer.lock还原依赖 -
composer.lock必须提交进 Git，不能忽略 - CI 脚本里禁止出现
composer update，连带禁用--ignore-platform-reqs这类掩耳盗铃参数 - 镜像构建时，
COPY . .后立刻composer install --no-dev --optimize-autoloader，然后COPY --from=0 /app/vendor /app/vendor分层缓存更稳
Slim/Laravel 等框架不是“微服务框架”，它们只是单服务运行时载体
有人以为 composer create-project slim/slim-skeleton user-service 就搭出微服务了——其实只是起了个 HTTP 服务进程。真正的微服务特征（服务发现、熔断、链路追踪）Slim 不提供，得靠 Consul、OpenTelemetry 或自研网关补足。
- 用
slim/slim-skeleton初始化比手敲index.php安全得多，它自带 PSR-7 实现（nyholm/psr7）、错误处理器、路由示例，避免getServerParams() not found这类隐形坑 - PHP 版本必须 ≥ 8.1（Slim 5 要求），别在
composer.json里写"php": "^7.4"还硬跑 - 微服务间调用必须关掉
displayErrorDetails，否则堆栈信息（含路径、DB 配置片段）会随 HTTP 响应吐给上游服务 - 别指望 Composer 自动解决跨服务事务一致性——它连数据库连接都不管，分布式事务得靠 Saga 模式或本地消息表
最易被忽略的一点：Composer 的 autoload 机制只在类首次使用时触发，Class not found 错误不会在 composer install 阶段暴露，而是在某个 API 路由被执行、某个 DTO 被反序列化时才炸。所以共享包的 autoload 配置、命名空间拼写、路径斜杠方向，必须在每个服务里单独验证，不能凭感觉“应该没问题”。
