PHP-CS-Fixer 中方法链缩进与双冒号空格的修复顺序问题

在 PHP 代码格式化工具 PHP-CS-Fixer 中，存在一个关于方法链缩进(method_chaining_indentation)和双冒号周围空格(no_space_around_double_colon)两个修复规则的执行顺序问题。这个问题会导致代码格式化结果不符合预期。

问题现象

当同时启用这两个规则时，代码格式化会出现异常情况。例如以下代码：

$formattedIncorrectly = Foo::bar
    ::baz()
                    ->where('id', 1)
    ->firstOrFail();

理想情况下应该被格式化为：

$formattedIncorrectly = Foo::bar::baz()
    ->where('id', 1)
    ->firstOrFail();

但实际格式化结果却变成了：

$formattedIncorrectly = Foo::bar::baz()
        ->where('id', 1)
        ->firstOrFail();

问题根源

这个问题源于两个修复器的执行顺序：

1. MethodChainingIndentationFixer（方法链缩进修复器）
2. NoSpaceAroundDoubleColonFixer（双冒号周围空格修复器）

这两个修复器都没有显式定义优先级（即都继承了AbstractFixer的默认优先级0），因此它们的执行顺序取决于它们在规则集中的定义顺序。当规则按字母顺序排序时，method_chaining_indentation会排在no_space_around_double_colon之前执行。

技术原理

在 PHP-CS-Fixer 中，修复器的执行顺序由以下因素决定：

1. 显式优先级：修复器可以通过实现getPriority()方法定义自己的优先级
2. 隐式顺序：当多个修复器具有相同优先级时，它们的执行顺序取决于定义顺序

对于方法链缩进和双冒号周围空格的处理，正确的执行顺序应该是：

1. 先处理双冒号周围的空间（合并或拆分双冒号）
2. 再处理方法链的缩进

这样才能确保最终的格式化结果符合预期。

解决方案

要解决这个问题，可以考虑以下两种方案：

1. 调整修复器优先级：为这两个修复器设置明确的优先级，确保NoSpaceAroundDoubleColonFixer先执行
2. 手动指定规则顺序：在配置文件中手动排列规则顺序，确保no_space_around_double_colon在method_chaining_indentation之前

对于 PHP-CS-Fixer 项目本身，更合适的解决方案是第一种，即为这两个修复器设置适当的优先级，这样无论它们在配置文件中以什么顺序出现，都能保证正确的执行顺序。

最佳实践

在实际使用 PHP-CS-Fixer 时，如果遇到类似的多规则交互问题，可以：

1. 检查相关修复器的优先级设置
2. 通过测试确定规则的执行顺序
3. 必要时调整配置文件中规则的顺序
4. 考虑向项目提交修复建议，完善修复器的优先级设置

这个问题也提醒我们，在开发代码格式化工具时，需要仔细考虑各个规则之间的依赖关系和执行顺序，以确保最终的格式化结果符合开发者的预期。