通过Composer本地安装Rector并初始化配置是提升PHP项目代码质量的关键，需指定paths、sets等规则集，用--dry-run预览修改，再运行测试验证。
通过Composer安装和配置Rector，是提升PHP项目代码质量与现代化升级效率的关键一步。核心在于正确安装、初始化配置，并根据项目需求选择合适的规则集。
安装Rector
推荐使用本地安装方式，避免全局依赖冲突。在项目根目录执行：
- composer require rector/rector --dev（安装为开发依赖）
- 安装完成后，可通过 vendor/bin/rector --version 验证是否成功
生成基础配置文件
Rector默认查找 rector.php 或 rector.yaml。运行以下命令自动生成推荐配置：
-
vendor/bin/rector init —— 会创建
rector.php并提示选择预设（如 PHP 7.4、8.0、Symfony、PHPUnit 等） - 若需手动配置，可在
rector.php中返回一个ContainerConfigurator闭包，调用$containerConfigurator->import()引入官方预设，例如：use Rector\Config\RectorConfig;
return static function (RectorConfig $rectorConfig): void {
$rectorConfig->paths(['src', 'tests']);
$rectorConfig->sets([SetList::PHP_80]);
};
指定重构范围与规则
配置中需明确作用路径和规则集，避免误改第三方代码或测试文件：
08cms企业建站系统 1.0 正式版
下载
08cms企业建站系统是基于08cmsv3.4核心程序，通过系统架构，模板制作，并根据此系统的功能和操作流程进行了代码优化。由08cms官方团队开发。安装链接：install.php、管理后台链接：admina.php日常管理请不要使用创始人帐号（admin），系统内置有内容管理帐号08cms：密码08cms系统特点：1、系统可自动生成静态页面；2、根据企业系统的特点，基于08cms V3.4核心
立即学习“PHP免费学习笔记（深入）”；
-
paths()：限定扫描目录，如
['src']、['app/Controllers'] -
sets()：引入官方规则集，常用包括
SetList::PHP_81、SetList::CODE_QUALITY、SetList::SYMFONY_64 -
rules()：单独启用某条规则，例如
$rectorConfig->rules([NewToConstructorInjectionRector::class]); - 可配合 skip() 排除特定文件或规则，如跳过 vendor 或某个类：
$rectorConfig->skip(['src/DeprecatedClass.php']);
运行与验证重构
首次运行建议先用 --dry-run 模式预览变更，确认无误后再执行实际修改：
- vendor/bin/rector process --dry-run：仅显示将要修改的文件和行号
- vendor/bin/rector process --no-progress-bar：关闭进度条，便于查看详细输出
- 添加 --debug 可定位规则匹配失败原因；--clear-cache 解决配置更新后未生效问题
- 重构后务必运行测试（
phpunit或./vendor/bin/phpunit），确保行为未改变
