告别单例噩梦：Rector如何一键实现依赖注入重构
项目地址: https://gitcode.com/GitHub_Trending/re/rector 你是否还在维护充斥着Singleton（单例模式）的遗留系统？那些硬编码的StaticCall（静态调用）正在扼杀代码的可测试性和扩展性。本文将展示如何使用Rector实现从单例模式到依赖注入（Dependency Injection）的自动化重构，让你的代码焕发新生。
单例模式的隐秘陷阱
单例模式曾经被视为解决资源共享问题的银弹，但它带来的副作用远超想象：
- 测试地狱：静态依赖导致单元测试无法隔离
- 紧耦合：组件间形成强依赖，重构如同拆弹
- 隐藏依赖：类的真实依赖关系被构造函数掩盖
// 典型的单例反模式
class UserService {
private static $instance;
public static function getInstance() {
if (!self::$instance) {
self::$instance = new self();
}
return self::$instance;
}
private function __construct() {}
}
// 无处不在的静态调用
$user = UserService::getInstance()->getUser(1);
Rector通过分析代码结构，能精准识别这类单例模式。相关的语法解析逻辑可参考preload.php中对StaticCall节点的处理。
依赖注入的救赎之道
依赖注入（Dependency Injection）通过构造函数显式声明依赖，彻底解决了单例模式的弊端：
// 重构后的依赖注入版本
class UserService {
public function __construct() {}
}
// 在需要的地方注入依赖
class UserController {
private $userService;
public function __construct(UserService $userService) {
$this->userService = $userService;
}
public function show() {
$user = $this->userService->getUser(1);
}
}
Rector的依赖注入重构能力分散在多个规则模块中，核心的类可见性调整由Visibility规则负责，而构造函数注入则由TypeDeclaration相关规则处理。
Rector重构实战四步法
1. 安装与配置
通过Composer安装Rector：
composer require rector/rector --dev
创建基础配置文件rector.php：
<?php
declare(strict_types=1);
use Rector\Config\RectorConfig;
return RectorConfig::configure()
->withPaths([
__DIR__ . '/src',
])
->withRules([
// 添加单例重构规则
]);
2. 单例检测与标记
Rector的DeadCode规则能自动识别未使用的单例方法。运行dry-run查看检测结果：
vendor/bin/rector process --dry-run
3. 执行自动化重构
启用单例到依赖注入的转换规则：
->withRules([
\Rector\Visibility\Rector\ClassMethod\ChangeSingletonToServiceRector::class,
\Rector\TypeDeclaration\Rector\ClassMethod\AddMethodParentParametersRector::class,
])
执行重构命令：
vendor/bin/rector process
4. 验证与优化
重构完成后，Rector会自动更新所有调用点。你可以通过PHPStan规则进行静态分析验证：
vendor/bin/phpstan analyze
重构前后代码对比
| 重构前（单例模式） | 重构后（依赖注入） |
|---|---|
| 静态方法调用 | 构造函数注入 |
| 私有构造函数 | 公共构造函数 |
| 隐藏依赖关系 | 显式依赖声明 |
| 无法模拟测试 | 轻松单元测试 |
深入Rector的重构原理
Rector通过抽象语法树（AST）分析代码结构，相关的节点处理逻辑位于Node/Expr/StaticCall.php。核心重构流程包括：
- 识别单例特征：检测私有构造函数和静态实例方法
- 修改类可见性：将私有构造函数改为公共，对应规则在Visibility/Rector
- 替换静态调用：在所有调用点注入依赖，由TypeDeclaration规则实现
- 添加类型声明：确保依赖注入的类型安全
常见问题与解决方案
循环依赖问题
当两个服务相互依赖时，可使用延迟注入模式。Rector的EarlyReturn规则能帮助优化这类代码结构。
遗留系统兼容性
对于无法完全重构的项目，可使用PhpDoc规则添加临时类型注解过渡。
总结与进阶
通过Rector实现单例到依赖注入的重构，不仅改善了代码质量，更建立了可持续的开发模式。建议结合PHPStan和PHPUnit形成完整的质量保障体系。
后续可深入学习：
立即行动，用Rector为你的代码库进行一次"体检"，告别单例噩梦，拥抱依赖注入带来的灵活性与可维护性！
本文配套示例代码已上传至示例仓库，可通过
rector init --demo命令获取完整演示项目。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
