RectorPHP项目中禁用并行处理的正确方式

并行处理与超时问题

在使用RectorPHP进行代码重构时，当处理大量PHP文件时可能会遇到"Child process timed out after 120 seconds"的错误提示。这是由于Rector默认启用了并行处理功能，而某些环境下子进程执行时间超过了预设的120秒限制。

两种配置方式禁用并行处理

RectorPHP提供了两种主要的配置方式，每种方式都有对应的禁用并行处理方法：

1. 使用RectorConfig::configure()的流式调用方式

这是较新的推荐配置方式，代码结构更加简洁：

return RectorConfig::configure()
    // 其他配置项...
    ->withoutParallel();

2. 使用闭包回调的传统配置方式

这是较早的配置方式，仍然被广泛支持：

return static function(RectorConfig $rectorConfig): void {
    // 其他配置项...
    $rectorConfig->disableParallel();
};

选择建议

对于新项目，建议使用第一种流式调用方式，代码更加清晰易读。对于现有项目，可以根据当前使用的配置方式选择对应的方法。

性能影响说明

禁用并行处理后，Rector将按顺序逐个处理文件，这可能会降低整体处理速度，但能避免并行处理带来的超时问题。对于大型项目，可以考虑以下折中方案：

1. 适当增加超时时间而非完全禁用并行
2. 分批处理文件
3. 优化重构规则减少单个文件处理时间

最佳实践

在实际项目中，建议先尝试调整超时时间而非直接禁用并行处理。只有在确认是并行处理本身导致问题的情况下，才考虑完全禁用该功能。