PHP对象循环依赖指的是两个或多个对象互相持有对方的引用，在实例化时形成闭环，导致无法正常完成对象创建，常见于业务层服务类之间的相互调用场景。比如用户服务需要调用订单服务的方法，同时订单服务也需要调用用户服务的方法，直接通过构造函数注入就会出现循环依赖问题。
为什么会出现PHP对象循环依赖
当我们在类中通过构造函数注入依赖时，实例化A需要先实例化B，实例化B又需要先实例化A，就会陷入死循环。以下是一个典型的循环依赖示例代码：
<?php
class UserService {
private OrderService $orderService;
public function __construct(OrderService $orderService) {
$this->orderService = $orderService;
}
public function getUserInfo(int $userId): array {
// 调用订单服务方法
$orders = $this->orderService->getOrdersByUserId($userId);
return ['id' => $userId, 'orders' => $orders];
}
}
class OrderService {
private UserService $userService;
public function __construct(UserService $userService) {
$this->userService = $userService;
}
public function getOrdersByUserId(int $userId): array {
// 调用用户服务方法
$user = $this->userService->getUserInfo($userId);
return ['user_id' => $userId, 'user_name' => $user['name']];
}
}
// 尝试实例化会直接报错
// $userService = new UserService(new OrderService(new UserService(...)));
?>
通过Setter注入解决循环依赖
Setter注入的思路是先实例化对象，再通过setter方法注入依赖，打破实例化时的闭环。具体实现步骤如下：
- 将依赖的注入方式从构造函数改为setter方法
- 先分别实例化两个对象，再调用setter方法互相注入依赖
- 确保调用依赖方法前已经完成注入，避免空指针问题
修改后的代码示例如下：
<?php
class UserService {
private ?OrderService $orderService = null;
// 不再通过构造函数注入
public function __construct() {}
// Setter方法注入依赖
public function setOrderService(OrderService $orderService): void {
$this->orderService = $orderService;
}
public function getUserInfo(int $userId): array {
if ($this->orderService === null) {
throw new RuntimeException('OrderService未注入');
}
$orders = $this->orderService->getOrdersByUserId($userId);
return ['id' => $userId, 'orders' => $orders];
}
}
class OrderService {
private ?UserService $userService = null;
public function __construct() {}
public function setUserService(UserService $userService): void {
$this->userService = $userService;
}
public function getOrdersByUserId(int $userId): array {
if ($this->userService === null) {
throw new RuntimeException('UserService未注入');
}
$user = $this->userService->getUserInfo($userId);
return ['user_id' => $userId, 'user_name' => $user['name']];
}
}
// 实例化对象
$userService = new UserService();
$orderService = new OrderService();
// 互相注入依赖
$userService->setOrderService($orderService);
$orderService->setUserService($userService);
// 正常使用
$result = $userService->getUserInfo(1);
print_r($result);
?>
通过依赖注入容器解决循环依赖
在大型项目中，手动管理Setter注入会比较繁琐，使用依赖注入容器可以自动处理循环依赖。容器会先创建对象实例，再延迟注入依赖，常见的PHP依赖注入容器如Symfony DI、Laravel容器都支持循环依赖处理。以下是基于自定义简单容器的实现示例：
<?php
class Container {
private array $instances = [];
private array $callbacks = [];
// 注册服务
public function set(string $id, callable $callback): void {
$this->callbacks[$id] = $callback;
}
// 获取服务，自动处理循环依赖
public function get(string $id) {
if (isset($this->instances[$id])) {
return $this->instances[$id];
}
if (!isset($this->callbacks[$id])) {
throw new RuntimeException("服务{$id}未注册");
}
// 先创建实例，再执行回调注入依赖
$this->instances[$id] = new stdClass();
$instance = $this->callbacks[$id]($this);
$this->instances[$id] = $instance;
return $instance;
}
}
// 注册服务
$container = new Container();
$container->set(UserService::class, function ($container) {
$service = new UserService();
// 延迟获取OrderService实例
$service->setOrderService($container->get(OrderService::class));
return $service;
});
$container->set(OrderService::class, function ($container) {
$service = new OrderService();
$service->setUserService($container->get(UserService::class));
return $service;
});
// 直接获取可用实例
$userService = $container->get(UserService::class);
$result = $userService->getUserInfo(1);
print_r($result);
?>
两种方案对比
| 方案 | 优点 | 缺点 | 适用场景 |
|---|---|---|---|
| Setter注入 | 实现简单，无额外依赖，逻辑清晰 | 需要手动管理注入顺序，依赖可能处于未注入状态 | 小型项目，循环依赖较少的场景 |
| 依赖注入容器 | 自动管理依赖，减少手动代码，适合复杂项目 | 需要引入容器组件，学习成本稍高 | 中大型项目，依赖关系复杂的场景 |
注意事项
虽然可以通过上述方式解决循环依赖，但循环依赖本身通常意味着代码结构存在不合理的地方，建议优先通过重构拆分职责、引入中间层等方式从根源上避免循环依赖，再考虑使用技术手段处理。如果必须使用循环依赖，要确保依赖注入的时机在调用依赖方法之前，避免出现空指针错误。
处理循环依赖的核心思路是打破实例化阶段的依赖闭环，先创建实例再注入依赖，或者使用容器延迟解析依赖。