六边形架构通过端口与适配器解耦核心业务逻辑和外部依赖，提升php应用的可测试性、灵活性和可维护性。1. 定义端口（接口）作为核心与外部交互的标准；2. 实现适配器对接具体外部系统（如mysql、redis）；3. 核心业务逻辑仅依赖端口，实现独立演进；4. 通过依赖注入动态切换适配器；5. 使用di容器管理复杂依赖关系；6. 单元测试中可用mock模拟外部行为。其优点包括解耦、易测试、灵活切换基础设施，适用于中大型需长期维护的项目，但会增加设计复杂度，适合逐步引入现有项目。
六边形架构，或者说端口与适配器模式，本质上是为了解耦核心业务逻辑和外部依赖。它让你的 PHP 应用更易于测试、维护，也更灵活，能轻松切换数据库、消息队列等基础设施。
解决方案
六边形架构的核心思想是将应用程序分为内部（核心业务逻辑）和外部（外部依赖，如数据库、消息队列、用户界面）。两者之间通过端口（Port）和适配器（Adapter）进行通信。
立即学习“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 PHPUnit\Framework\TestCase;
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());
}
}六边形架构的优缺点是什么？
优点：
- 解耦性： 核心业务逻辑与外部依赖解耦，易于测试、维护和演进。
- 可测试性： 可以使用 Mock 对象或 Stub 对象来模拟外部依赖，方便进行单元测试。
- 灵活性： 可以轻松切换不同的适配器实现，例如切换数据库或消息队列。
- 可扩展性： 易于添加新的适配器，以支持新的外部依赖。
缺点：
- 复杂性： 增加了代码的复杂性，需要更多的接口和类。
- 学习曲线： 需要理解端口和适配器的概念，有一定的学习曲线。
- 过度设计： 如果应用规模较小，可能过度设计。
在哪些类型的 PHP 项目中应该使用六边形架构？
中大型项目，特别是那些需要长期维护、频繁变更外部依赖的项目，六边形架构的优势会更加明显。 如果你的项目需要支持多种数据库、消息队列或其他外部服务，那么六边形架构可以帮助你更好地管理这些依赖关系。
如何在现有的 PHP 项目中逐步引入六边形架构？
不要试图一次性重构整个项目。 可以从一个小的模块开始，逐步将其他模块迁移到六边形架构。 识别出项目中与外部依赖耦合最紧密的部分，然后从这些部分开始重构。
