Rector可自动化PHP版本和框架升级，通过Composer安装并配置rector.php文件，指定扫描路径与目标版本如PHP 8.0或Laravel 9，运行命令执行重构，支持干跑预览与实际修改，建议结合Git管理变更以确保安全。
想把老项目升级到新版PHP或新框架，但手动改代码太费劲？Rector 是一个强大的 PHP 代码自动重构工具，能帮你快速完成版本迁移。通过 Composer 安装和配置 Rector，可以自动化执行大量重复的代码修改，比如函数替换、类名更新、语法升级等。
安装 Rector via Composer
在项目根目录下使用 Composer 安装 Rector，推荐作为开发依赖引入：
composer require rector/rector --dev这样不会影响生产环境，只在本地用于代码分析和重构。
如果你只想全局安装以便多个项目使用，也可以用：
composer global require rector/rector注意全局使用时需确保 ~/.composer/vendor/bin 在你的系统 PATH 中。
创建 Rector 配置文件
在项目根目录创建 rector.php 配置文件，这是 Rector 的核心控制文件。
例如，将代码从 PHP 7.3 升级到 8.0，配置如下：
use Rector\Config\RectorConfig;return static function (RectorConfig $rectorConfig): void {
$rectorConfig->paths([
__DIR__ . '/src',
__DIR__ . '/tests',
]);
// 使用内置的 PHP 8.0 升级规则集
$rectorConfig->importNames();
$rectorConfig->phpVersion(\Rector\Core\ValueObject\PhpVersion::PHP_80);
};
这个配置告诉 Rector 扫描 /src 和 /tests 目录，并应用 PHP 8.0 兼容性所需的变更，比如 mixed 类型声明、命名参数支持等。
运行 Rector 进行代码重构
配置好后，直接在终端运行：
./vendor/bin/rector processRector 会扫描指定目录，显示将要修改的文件。默认是“干运行”模式，不会真正写入文件。
确认无误后，加上 --dry-run=0 参数让 Rector 实际修改代码：
./vendor/bin/rector process --dry-run=0你也可以指定特定规则来测试效果，比如修复命名导入：
./vendor/bin/rector process src/SomeFile.php --rule=ImportNamesRector结合规则集进行框架升级
Rector 支持 Laravel、Symfony、Nette 等主流框架的版本升级。以 Laravel 8 到 9 升级为例：
$rectorConfig->sets([\Rector\Set\ValueObject\SetList::LARAVEL_90,
]);
这会自动处理废弃方法替换、类型声明增强、配置结构调整等问题。
查看官方文档获取对应框架和 PHP 版本的规则集名称，确保使用正确的 set。
基本上就这些。Rector 能大幅减少升级成本，但建议每次运行前提交当前代码，防止意外修改。配合 Git diff 检查变更，确保逻辑正确。自动化是捷径，审慎使用才安全。
