CakePHP 3升级至4.0：执行bin/cake upgrade rector命令卡顿求助

这种Rector卡在0%不动的情况我之前帮朋友排查过好几次，给你几个实用的排查和解决方向：

• 缩小测试范围定位问题文件
  不要一次性扫描整个tests目录，先挑一个小型的测试文件试试，比如：

  bin/cake upgrade rector --rules phpunit80 C:\xampp\htdocs\my_app\tests\TestCase\Controller\HomeControllerTest.php
  

  如果这个命令能正常执行，说明是某个特定的大文件或者有语法问题的文件导致卡住，再逐步扩大范围找到问题文件。

• 升级Rector版本
  你当前用的是Rector v0.7.26，这个版本比较老旧，可能存在性能瓶颈或者兼容性问题。进入upgrade工具目录，执行：

  composer update rector/rector
  

  更新到兼容CakePHP 4和PHPUnit 8的较新版本后再重试命令。

• 调高PHP内存限制
  Windows下XAMPP的默认PHP内存限制可能不足以支撑Rector处理大量测试文件。可以临时调高内存后再执行命令：

  php -d memory_limit=2G bin/cake upgrade rector --rules phpunit80 C:\xampp\htdocs\my_app\tests
  

  如果是内存不足导致的假死，这个方法通常能解决。

• 开启 verbose 模式查看详细日志
  添加-vvv参数让Rector输出详细执行日志，这样能看到它卡在哪个步骤或者文件：

  bin/cake upgrade rector -vvv --rules phpunit80 C:\xampp\htdocs\my_app\tests
  

  根据日志里的最后一行内容，就能定位到具体的卡点。

• 排除特殊文件
  检查tests目录里有没有非PHP文件、超大文件，或者自动生成的测试数据文件？先把这些文件临时移出去，再重新执行命令，确认是不是这类文件导致Rector解析卡住。

• 手动处理PHPUnit 8兼容变更
  如果以上方法都无效，也可以跳过这个Rector命令，手动完成PHPUnit 8的兼容修改：

  • 将测试类中的setUp()、tearDown()方法添加返回类型声明: void
  • 替换过时的断言方法，比如assertInternalType('array', $var)改成assertIsArray($var)，assertInstanceOf()的参数顺序调整为assertInstanceOf(ExpectedType::class, $actual)
  • 移除@expectedException这类注解，改用$this->expectException()方法

内容的提问来源于stack exchange，提问作者dividedbyzero