PHP-CS-Fixer项目中关于完全限定类名规则的改进探讨

在PHP代码规范工具PHP-CS-Fixer中，有一个关于fully_qualified_strict_types规则的改进需求值得开发者关注。这个规则主要用于自动处理代码中的完全限定类名(FQCN)问题，但当前版本对多属性声明场景的支持存在不足。

问题背景

在PHP 8.0引入属性(Attributes)功能后，开发者可以在类、方法等结构上使用#[...]语法添加元数据。一个常见的使用模式是在一个属性组内声明多个属性，例如：

namespace Ns;

#[
    \A\B(),
    \A\C,
]
class Foo {}

当前PHP-CS-Fixer的fully_qualified_strict_types规则只能正确处理第一个属性(\A\B)，而会忽略后续属性(\A\C)的导入处理。这导致代码规范检查不完整，可能影响代码质量和一致性。

技术分析

从实现角度看，这个问题涉及到PHP解析器的几个关键点：

1. 属性语法解析：PHP 8.0允许在单个#[]块中包含多个属性声明，用逗号分隔。这种语法结构需要被完整解析。

2. 命名空间处理：当检测到完全限定类名(以反斜杠开头的类名)时，工具应该能够识别并处理这些类名的导入。

3. AST遍历：需要确保代码抽象语法树(AST)的遍历能够覆盖所有属性节点，而不仅仅是第一个。

解决方案方向

根据项目维护者的反馈，这个问题在另一个相关PR(#7909)合并后应该能够较容易地解决。可能的实现路径包括：

1. 扩展属性收集逻辑：修改现有代码，确保从任何#[]块中收集所有属性项。

2. 类名导入机制：为检测到的使用类(used classes)添加导入逻辑，无论它们出现在属性组的哪个位置。

3. 测试用例完善：添加针对多属性场景的测试用例，确保各种排列组合都能被正确处理。

对开发者的影响

这个改进将使得：

1. 代码规范检查更加全面，不再遗漏属性组中的后续属性。

2. 自动导入功能更加完善，减少开发者手动调整的需要。

3. 代码风格更加统一，特别是在大型项目中使用多个第三方库属性的场景。

最佳实践建议

在等待官方修复的同时，开发者可以：

1. 暂时将多个属性分开声明，每个属性使用独立的#[]语法。

2. 在项目中使用自定义规则或补丁来临时解决这个问题。

3. 关注项目更新，及时升级到包含此修复的版本。

这个改进虽然看似小，但对于保持代码规范工具在处理现代PHP语法时的完整性具有重要意义，特别是在属性(Attributes)使用日益广泛的背景下。