RectorPHP项目中参数类型声明配置的正确使用方法

问题背景

在RectorPHP项目中，开发者经常需要对代码进行类型声明相关的重构。近期发现一个常见错误配置案例，涉及AddParamTypeDeclarationRector规则的使用方式。这个规则用于为类方法参数添加类型声明，但很多开发者在使用时容易忽略正确的配置格式。

错误现象

当开发者尝试在Rector配置中错误地设置PHP版本时，系统会抛出致命错误。具体表现为：

PHP Fatal error: Uncaught RectorPrefix202504\Webmozart\Assert\InvalidArgumentException: Expected an instance of this class or to this class among its parents "Rector\TypeDeclaration\ValueObject\AddParamTypeDeclaration". Got: 70000

这个错误表明系统期望接收一个特定类型的参数，但实际得到了一个PHP版本号(70000代表PHP 7.0.0)，这显然不符合预期。

根本原因分析

错误的核心在于配置方式不正确。开发者可能误将PHP版本设置直接放在规则配置数组中，而实际上：

1. PHP版本应该在Rector配置的顶层设置，而不是在单个规则的配置中
2. AddParamTypeDeclarationRector需要接收特定格式的参数类型声明配置对象

正确配置方法

正确的配置应该遵循以下模式：

1. 首先在Rector配置顶层设置PHP版本
2. 然后为AddParamTypeDeclarationRector提供符合其要求的参数类型声明配置

配置示例应该包含具体的类名、方法名和参数位置信息，而不是简单的PHP版本号。

最佳实践建议

1. 版本控制：始终在Rector配置的顶层设置PHP版本，确保所有规则都能正确识别目标环境
2. 规则配置：仔细阅读每个Rector规则的文档，了解其所需的配置格式
3. 类型安全：使用IDE的类型提示功能来验证配置对象的正确性
4. 渐进式迁移：对于大型项目，建议分阶段进行类型声明迁移，先从简单的类开始

总结

在RectorPHP项目中正确配置参数类型声明规则需要开发者理解规则的具体需求。通过遵循正确的配置模式和版本设置方式，可以避免常见的配置错误，确保代码重构过程顺利进行。记住，每个Rector规则都有其特定的配置要求，仔细阅读文档和示例是成功实施重构的关键。