RectorPHP 类型声明转换规则详解

类型声明自动转换原理

RectorPHP 作为一款强大的 PHP 代码重构工具，能够自动将 PHPDoc 注释中的类型提示转换为现代 PHP 的类型声明语法。这一功能对于代码现代化改造尤为重要，特别是在升级到 PHP 7.4+ 版本时。

参数类型声明转换

RectorPHP 能够识别 @param 注释中的类型声明，并将其转换为函数参数的类型提示。例如：

/**
 * @param int|null $storeId
 */
public function getBaseUrl($storeId = null): string

可以自动转换为：

public function getBaseUrl(?int $storeId = null): string

要实现这一转换，需要使用 TYPE_DECLARATION 规则集。在 Rector 配置文件中添加：

$rectorConfig->sets([
    \Rector\Set\ValueObject\SetList::TYPE_DECLARATION
]);

属性类型声明转换

RectorPHP 同样支持将类属性的 PHPDoc 类型注释转换为类型声明：

/**
 * @var string
 */
protected $fileName = '/var/log/filename.log';

可以转换为：

protected string $fileName = '/var/log/filename.log';

需要注意的是，对于 protected 属性的类型声明转换可能会影响子类继承，因此默认情况下 Rector 只处理 private 属性。如需处理 protected 属性，需要进行额外配置。

类型推断机制

RectorPHP 的类型推断非常智能，它会：

1. 分析 PHPDoc 注释中的类型提示
2. 检查变量赋值和使用情况
3. 考虑方法调用链中的类型信息
4. 确保转换不会破坏现有代码逻辑

最佳实践建议

1. 逐步应用：建议先在小范围代码中测试类型转换效果
2. 关注 BC 破坏：特别注意 protected 属性的转换可能影响子类
3. 组合使用规则：TYPE_DECLARATION 与其他规则集配合使用效果更佳
4. 代码审查：转换后仍需人工检查确保逻辑正确性

通过合理配置 RectorPHP，开发者可以高效地将传统 PHP 代码升级为符合现代 PHP 标准的代码，提升代码质量和可维护性。