六边形架构通过端口与适配器解耦核心业务逻辑和外部依赖，提升
php
应用的可测试性、灵活性和可维护性。1. 定义端口（接口）作为核心与外部交互的标准；2. 实现适配器对接具体外部系统（如
mysql
、
redis
）；3. 核心业务逻辑仅依赖端口，实现独立演进；4. 通过依赖注入动态切换适配器；5. 使用di容器管理复杂依赖关系；6. 单元测试中可用mock模拟外部行为。其优点包括解耦、易测试、灵活切换基础设施，适用于中大型需长期维护的项目，但会增加设计复杂度，适合逐步引入现有项目。
六边形架构，或者说端口与适配器模式，本质上是为了解耦核心业务逻辑和外部依赖。它让你的 PHP 应用更易于测试、维护，也更灵活，能轻松切换数据库、消息队列等基础设施。
解决方案
六边形架构的核心思想是将应用程序分为内部（核心业务逻辑）和外部（外部依赖，如数据库、消息队列、用户界面）。两者之间通过端口（Port）和适配器（Adapter）进行通信。
立即学习
“
PHP免费学习笔记（深入）
”；
定义端口（Port）：
端口是接口，定义了核心业务逻辑与外部世界交互的方式。例如，一个用户管理系统可能有一个
端口，定义了获取、创建、更新和删除用户的方法。
实现适配器（Adapter）：
适配器实现了端口，并将端口的调用转换为外部系统的特定实现。例如，
端口可以有多个适配器，一个使用 MySQL 数据库，另一个使用 Redis 缓存。
核心业务逻辑：
核心业务逻辑只依赖于端口，而不依赖于具体的适配器实现。这使得核心业务逻辑可以独立于外部依赖进行测试和演进。
依赖注入：
使用依赖注入将适配器注入到核心业务逻辑中。这可以通过构造函数注入、setter 注入或接口注入来实现。
如何在PHP中管理依赖关系以支持六边形架构？
依赖注入容器是关键。像 Symfony 的 DependencyInjection 组件或者 Laravel 的 IoC 容器，都可以帮你管理对象之间的依赖关系，并轻松地切换不同的适配器实现。 手动管理当然也可以，但随着项目规模的增长，你会发现依赖注入容器能节省大量时间和精力。
PHP 8.5.5
PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。
下载
如何测试六边形架构中的核心业务逻辑？
因为核心业务逻辑只依赖于端口，所以你可以使用 Mock 对象或 Stub 对象来模拟外部依赖的行为。 这使得你可以专注于测试核心业务逻辑的正确性，而无需担心外部依赖的影响。
六边形架构的优缺点是什么？
优点：
解耦性：
核心业务逻辑与外部依赖解耦，易于测试、维护和演进。
可测试性：
可以使用 Mock 对象或 Stub 对象来模拟外部依赖，方便进行单元测试。
灵活性：
可以轻松切换不同的适配器实现，例如切换数据库或消息队列。
可扩展性：
易于添加新的适配器，以支持新的外部依赖。
缺点：
复杂性：
增加了代码的复杂性，需要更多的接口和类。
学习曲线：
需要理解端口和适配器的概念，有一定的学习曲线。
过度设计：
如果应用规模较小，可能过度设计。
在哪些类型的 PHP 项目中应该使用六边形架构？
中大型项目，特别是那些需要长期维护、频繁变更外部依赖的项目，六边形架构的优势会更加明显。 如果你的项目需要支持多种数据库、消息队列或其他外部服务，那么六边形架构可以帮助你更好地管理这些依赖关系。
如何在现有的 PHP 项目中逐步引入六边形架构？
不要试图一次性重构整个项目。 可以从一个小的模块开始，逐步将其他模块迁移到六边形架构。 识别出项目中与外部依赖耦合最紧密的部分，然后从这些部分开始重构。
UserRepositoryinterface UserRepository
{
public function findById(int $id): ?User;
public function save(User $user): void;
public function delete(User $user): void;
}UserRepositoryclass 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;
}
}// 使用 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);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());
}
}