Composer虚拟包如何定义接口？解耦开发标准规范-composer-PHP中文网

虚拟包是type为virtual、仅含replace字段的占位符，无代码无autoload，只解决依赖冲突；真正定义接口的是psr/log等psr包，它们通过psr-4自动加载提供可被识别和使用的契约接口。

composer虚拟包如何定义接口？解耦开发标准规范

Composer 虚拟包本身不定义接口——它只是个“占位符”，真正定义接口的是 PSR 包或你自己的抽象包。 用 composer require psr/log 这类操作，装的不是实现，而是契约；虚拟包（如 php-fig/log）连代码都没有，只靠 replace 声明告诉 Composer：“我提供这个接口，别再装别的了”。搞反顺序，就会在 autoloading 或类型提示时出错。

什么是虚拟包？为什么它不能放接口代码

虚拟包是 composer.json 中 type 为 virtual、且仅含 replace 字段的包，例如：

{
  "name": "myorg/logging-contract",
  "type": "virtual",
  "replace": {
    "psr/log": "^3.0"
  }
}

它没有 src/，没有 autoload，也没有任何 PHP 文件。Composer 只把它当“声明”用：一旦项目 require 了 psr/log，而你又提前 require 了这个虚拟包，Composer 就会跳过安装真实 psr/log，并认为契约已满足。

虚拟包无法被 autoload —— 没有文件可映射命名空间
IDE 和 PHPStan 不会识别其中的接口 —— 因为根本不存在 LoggerInterface 的定义
它只解决依赖图冲突，不参与运行时类型校验

接口该放在哪？PSR 包才是标准载体

真正承载接口定义的，是官方 PSR 包，比如 psr/log、psr/container。它们是纯接口库，不含实现，体积小、无依赖、可被任意框架复用。

psr/log 提供 LoggerInterface，所有日志服务必须实现它
psr/http-message 定义 RequestInterface / ResponseInterface，是 Guzzle、Slim、Hyperf 共同遵循的边界
这些包的 composer.json 明确声明 "autoload": {"psr-4": {"Psr\Log\": "src/"}}，所以能被自动加载和类型提示识别

你自己的接口包也应照此结构：独立命名空间、PSR-4 自动加载、零实现、只含 .php 接口文件。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

如何用 Composer 实现“接口解耦”？关键在 require + type + autoload 配合

想让业务代码只依赖接口、不绑定实现，得靠三者协同：

业务代码 require 接口包（如 "psr/container": "^2.0"），而非具体容器（如 hyperf/di）
实现包在 composer.json 中用 "provide" 声明自己实现了哪些接口："provide": {"psr/container-implementation": "1.0"}
接口包自身必须带正确的 autoload，否则 new ContainerInterface() 会报 Class not found

常见错误是：自己写了个 MyContainerInterface，但没配 autoload，也没发布到 Packagist；结果别人 require 后，PHP 找不到类，却以为是 Composer 没装上。

本地开发接口包时，autoload 和路径映射最容易漏掉

用 path 仓库方式本地开发接口包，composer.json 必须显式写全 autoload：

{
  "name": "myorg/core-contracts",
  "autoload": {
    "psr-4": {
      "MyOrg\Contracts\": "src/"
    }
  }
}

否则即使 composer install 成功，MyOrgContractsContainerInterface 仍不会被加载。

别依赖 IDE 自动补全来判断接口是否存在——先跑 composer dump-autoload -o 看是否报错
用 composer show myorg/core-contracts 确认 autoload 配置已生效
测试时直接 new 一个接口会 fatal error，正确姿势是写个实现类，再 implements MyOrgContractsContainerInterface

接口解耦的成败，不在 replace 或 provide 的花哨配置，而在那一行 "MyOrg\Contracts\": "src/" 是否准确、是否被 Composer 读到、是否和实际文件结构对得上。