使用Rector重构PHP代码：静态方法调用与命名空间修改指南

理解重构需求

在PHP项目开发中，我们经常需要对现有代码进行重构。本文将以一个典型场景为例，演示如何使用Rector工具将静态方法调用从ClassD::getA()修改为ClassC::getB()->getValue()的形式，同时处理相关的命名空间引用变更。

原始代码与目标代码对比

原始代码结构如下：

use \Namespace\ClassD;

ClassD::getA();
ClassD::getA(1,2,3);

期望重构后的代码：

use \Namespace\ClassC;

ClassC::getB()->getValue();
ClassC::getB()->getValue(1, null, 2,3);

分步重构方案

第一步：类名和方法名重命名

Rector提供了两个内置规则可以完成基础的重构工作：

1. RenameClassRector：用于重命名类引用
2. RenameMethodRector：用于重命名方法调用

这两个规则可以处理类名从ClassD到ClassC的变更，以及方法名从getA到getB的修改。

第二步：处理命名空间导入

Rector会自动处理use语句的更新。当类名被重命名后，相关的use语句也会相应更新。如果旧类不再被使用，Rector还会自动移除未使用的导入语句。

第三步：方法调用链转换

将简单的静态方法调用转换为方法调用链(getB()->getValue())需要自定义规则。这里需要理解PHP-Parser的抽象语法树(AST)结构：

1. 原始代码中的ClassD::getA()是一个StaticCall节点
2. 目标代码中的ClassC::getB()->getValue()是一个MethodCall节点，它的var属性是另一个StaticCall节点

自定义规则实现要点

创建自定义规则时需要注意：

1. 需要匹配特定的StaticCall节点
2. 将匹配到的节点转换为MethodCall结构
3. 正确处理参数传递，特别是当需要在中间插入参数时(如示例中的null值)

参数处理技巧

当需要修改方法调用的参数列表时，可以通过以下方式操作：

1. 获取原始参数列表：$node->args或$node->getArgs()
2. 创建新的参数数组，可以在指定位置插入新参数
3. 使用new Arg()创建新的参数节点

最佳实践建议

1. 先使用内置规则完成基础重构
2. 再通过自定义规则处理复杂转换
3. 使用AST可视化工具理解代码结构
4. 编写测试用例验证重构结果

通过这种分步重构的方式，可以确保代码转换的准确性和安全性，同时保持代码的可维护性。