如何通过Composer安装 Rector 库实现 PHP 代码的自动升级与重构-composer-PHP中文网

rector不能通过composer require rector/rector --dev直接运行，因其需绕过项目自动加载自行扫描类，否则导致类找不到、依赖冲突、内存溢出；正确方式是用composer create-project隔离安装，并严格配置路径、规则集和文件扩展名。

如何通过composer安装 rector 库实现 php 代码的自动升级与重构

不能靠 composer require rector/rector --dev 装完就直接跑 —— 这是绝大多数人第一步就踩进的坑。Rector 不是普通 Composer 包，它必须在兼容的 PHP 环境中以独立工具方式运行，且严重依赖项目自动加载配置、PHP 版本对齐和显式规则声明。

这不是安装命令错了，而是它只解决“把文件放进来”，没解决“能不能跑起来”。常见现象包括：

Class "RectorCoreApplicationRectorApplication" not found：Rector 自身类被项目 autoloader 错误覆盖或加载顺序混乱
执行 vendor/bin/rector process 卡住、OOM 或无输出：PHP 内存限制未绕过，或底层 nikic/php-parser 版本不匹配源码语法（比如用 PHP 8.1 解析 PHP 5.6 的 yield from）
报 Could not find rector.php config file：配置文件缺失，而 Rector 默认不启用任何规则
改了代码但没生效：项目 composer.json 的 autoload 没覆盖待处理目录（如只写了 autoload-dev，Rector 默认不读）

Rector 启动前，这三项缺一不可，漏掉任意一个都会导致失败或跳过文件：

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

rector.php：根目录下必须存在，内容必须返回 static function (RectorConfig $config): void，不能包在嵌套闭包里（v0.23+ 和 v1.x 语法不兼容）
composer.json 中的 autoload 或 autoload-dev：要重构的路径（如 src/）必须已注册为 PSR-4 或 classmap，否则 Class not found 报错无法避免
--autoload-file 参数（可选但常需）：若重构的是未纳入 autoload 的脚本（如 bin/ 下 CLI 工具），必须显式传入 --autoload-file vendor/autoload.php 或在配置中加 $config->autoloadPaths(['bin/'])

不加这些，90% 情况下会提示 “No files changed” 或直接退出：

--dry-run：首次运行必须加，否则改错没法回滚
--set php80（或 php81、php82）：不指定 set，Rector 默认不启用任何规则；别信“自动检测版本”，它不会猜你目标
--paths="src,tests" 或配置中 $config->paths(['src', 'tests'])：默认只扫 src 和 tests，其他目录（如 app、lib）必须显式声明
--no-progress-bar：CI 环境下必加，否则因无 TTY 卡住

从 PHP 7.4 升到 8.2，不能只套 SetList::PHP_82 —— Rector 规则集不是全量覆盖，而是按版本分层设计：

必须逐级应用：先 php80，再 php81，最后 php82；跳版本会导致 ??=、match、enum 等语法遗漏
第三方生态规则需额外启用：Laravel 项目不加 SetList::LARAVEL_10，@phpstan-ignore-next-line 注解不会被清理；Doctrine 实体里的 @ORMColumn(type="string") 也不会转成属性类型
SetList::DEAD_CODE 看似安全，但可能删掉被 ReflectionClass 动态调用的私有方法，上线前必须 grep -r "new \\Reflection" . 扫描反射入口