如何通过接口组合实现灵活的依赖注入与职责分离

本文介绍如何利用接口继承与组合解决多职责类无法统一实现同一接口的问题，通过定义细粒度接口并组合使用，确保代码既符合开闭原则，又支持类型安全的依赖注入。

在面向对象设计中，接口的核心价值在于声明契约——它不规定“你是谁”，而明确“你能做什么”。当一个类（如 LogUserService）需要同时具备日志记录（log()）和属性设置（setAttr()）两种能力，但另一同类（如 LogDownloadService）仅需前者时，强行让所有类实现同一宽泛接口（如 SystemLogInterface）会违背接口隔离原则（ISP），导致调用方被迫依赖未使用的方法，或因缺失方法而编译失败。

正确的做法是采用接口拆分 + 组合策略：

1. 定义原子级职责接口

首先将不同职责抽象为独立接口，确保单一、正交：

interface SystemLogInterface {     public function log(string $type): void; }  interface AttributeConfigurableInterface {     public function setAttr(mixed $value): void; }

2. 创建组合接口（可选，提升语义清晰度）

若某类需同时满足两类契约，可定义组合接口，显式表达其复合能力：

interface LoggableWithAttributesInterface extends SystemLogInterface, AttributeConfigurableInterface {     // 空接口，仅作类型标记（php 支持多重继承接口） }

3. 各类按需实现对应接口

• LogDownloadService 仅实现基础日志能力：

  class LogDownloadService implements SystemLogInterface {     public function log(string $type): void     {         // 实际日志逻辑     } }

• LogUserService 实现复合能力：

  class LogUserService implements LoggableWithAttributesInterface {     private mixed $attr;      public function setAttr(mixed $value): void     {         $this->attr = $value;     }      public function log(string $type): void     {         // 日志逻辑（可结合 $this->attr）     } }

4. 调用方按需声明依赖

• 仅需日志功能的方法，继续依赖 SystemLogInterface，完全兼容新旧实现：

  public function processLog(SystemLogInterface $logger): void {     $logger->log('info'); }

• 需要配置+日志的场景，则依赖组合接口（或直接依赖 AttributeConfigurableInterface）：

  public function foo(LoggableWithAttributesInterface $service): void {     $service->setAttr($this->getAttr());     $service->log('user_action'); }

✅ 优势总结： 零侵入扩展：新增 LogEmailService 仅需日志能力？实现 SystemLogInterface 即可； 类型安全切换：foo() 方法参数类型为 LoggableWithAttributesInterface，ide 和 PHPStan 可静态校验 setAttr() 存在性； 符合 SOLID 原则：接口隔离（ISP）、开闭（OCP）、里氏替换（lsp）全部满足； 避免“伪实现”：无需在 LogDownloadService 中空实现 setAttr()，杜绝无意义方法污染。

最后提醒：接口命名应聚焦行为契约（如 LoggerInterface, ConfigurableInterface），而非系统层级（SystemLogInterface）。类名也宜保持语义一致（如 UserLogger 而非 LogUserService），这既是代码可读性的基石，也是设计成熟度的体现。