PHP中的六边形架构：如何实现端口与适配器模式-小浪学习网

六边形架构通过端口与适配器解耦核心业务逻辑和外部依赖，提升php应用的可测试性、灵活性和可维护性。1. 定义端口（接口）作为核心与外部交互的标准；2. 实现适配器对接具体外部系统（如mysql、redis）；3. 核心业务逻辑仅依赖端口，实现独立演进；4. 通过依赖注入动态切换适配器；5. 使用di容器管理复杂依赖关系；6. 单元测试中可用mock模拟外部行为。其优点包括解耦、易测试、灵活切换基础设施，适用于中大型需长期维护的项目，但会增加设计复杂度，适合逐步引入现有项目。

PHP中的六边形架构：如何实现端口与适配器模式

六边形架构，或者说端口与适配器模式，本质上是为了解耦核心业务逻辑和外部依赖。它让你的 PHP 应用更易于测试、维护，也更灵活，能轻松切换数据库、消息队列等基础设施。

PHP中的六边形架构：如何实现端口与适配器模式

解决方案

PHP中的六边形架构：如何实现端口与适配器模式

六边形架构的核心思想是将应用程序分为内部（核心业务逻辑）和外部（外部依赖，如数据库、消息队列、用户界面）。两者之间通过端口（Port）和适配器（Adapter）进行通信。

立即学习“PHP免费学习笔记（深入）”；

PHP中的六边形架构：如何实现端口与适配器模式

定义端口（Port）： 端口是接口，定义了核心业务逻辑与外部世界交互的方式。例如，一个用户管理系统可能有一个UserRepository端口，定义了获取、创建、更新和删除用户的方法。
```
interface UserRepository {     public function findById(int $id): ?User;     public function save(User $user): void;     public function delete(User $user): void; }
```

实现适配器（Adapter）： 适配器实现了端口，并将端口的调用转换为外部系统的特定实现。例如，UserRepository端口可以有多个适配器，一个使用 mysql 数据库，另一个使用 redis 缓存。

class MySQLUserRepository implements UserRepository {     private PDO $pdo;      public function __construct(PDO $pdo)     {         $this->pdo = $pdo;     }      public function findById(int $id): ?User     {         // 使用 $this->pdo 查询 MySQL 数据库         // ...     }      public function save(User $user): void     {         // 使用 $this->pdo 保存到 MySQL 数据库         // ...     }      public function delete(User $user): void     {         // 使用 $this->pdo 从 MySQL 数据库删除         // ...     } }  class redisUserRepository implements UserRepository {     private Redis $redis;      public function __construct(Redis $redis)     {         $this->redis = $redis;     }      public function findById(int $id): ?User     {         // 使用 $this->redis 从 Redis 缓存获取         // ...     }      public function save(User $user): void     {         // 使用 $this->redis 保存到 Redis 缓存         // ...     }      public function delete(User $user): void     {         // 使用 $this->redis 从 Redis 缓存删除         // ...     } }

核心业务逻辑： 核心业务逻辑只依赖于端口，而不依赖于具体的适配器实现。这使得核心业务逻辑可以独立于外部依赖进行测试和演进。

class UserService {     private UserRepository $userRepository;      public function __construct(UserRepository $userRepository)     {         $this->userRepository = $userRepository;     }      public function registerUser(string $name, string $email): User     {         $user = new User($name, $email);         $this->userRepository->save($user);         return $user;     } }

依赖注入： 使用依赖注入将适配器注入到核心业务逻辑中。这可以通过构造函数注入、setter 注入或接口注入来实现。

// 使用 MySQL 适配器 $pdo = new PDO('mysql:host=localhost;dbname=mydb', 'user', 'password'); $userRepository = new MySQLUserRepository($pdo); $userService = new UserService($userRepository);  // 使用 Redis 适配器 $redis = new Redis(); $redis->connect('127.0.0.1', 6379); $userRepository = new RedisUserRepository($redis); $userService = new UserService($userRepository);

如何在PHP中管理依赖关系以支持六边形架构？

依赖注入容器是关键。像 symfony 的 DependencyInjection 组件或者 laravel 的 IoC 容器，都可以帮你管理对象之间的依赖关系，并轻松地切换不同的适配器实现。手动管理当然也可以，但随着项目规模的增长，你会发现依赖注入容器能节省大量时间和精力。

如何测试六边形架构中的核心业务逻辑？

因为核心业务逻辑只依赖于端口，所以你可以使用 Mock 对象或 Stub 对象来模拟外部依赖的行为。这使得你可以专注于测试核心业务逻辑的正确性，而无需担心外部依赖的影响。

use PHPUnitFrameworkTestCase;  class UserServiceTest extends TestCase {     public function testRegisterUser(): void     {         // 创建一个 UserRepository 的 Mock 对象         $userRepository = $this->createMock(UserRepository::class);          // 设置 Mock 对象的行为         $userRepository->expects($this->once())             ->method('save')             ->with($this->isInstanceOf(User::class));          // 创建 UserService 对象，并将 Mock 对象注入         $userService = new UserService($userRepository);          // 调用 registerUser 方法         $user = $userService->registerUser('John Doe', 'john.doe@example.com');          // 断言返回的用户对象         $this->assertEquals('John Doe', $user->getName());         $this->assertEquals('john.doe@example.com', $user->getEmail());     } }

六边形架构的优缺点是什么？

优点：