Rector 需在 PHP 8+ 环境安装并运行，旧项目（如 PHP 5.6）仅存配置和 vendor；须显式配置 SetList::PHP_80 及 fileExtensions(['php'])，并确保 nikic/php-parser 版本足够新以解析旧语法。
Composer 安装 Rector 时为什么总报错 php ^8.0 不满足？
Rector 本身从 v1.0 开始已要求 PHP 8.0+ 运行环境，但很多人想用它升级旧项目（比如 PHP 5.6 的代码），就卡在安装这一步：Composer 拒绝安装，报错类似 Your requirements could not be resolved to an installable set of packages.，根本原因是 Composer 在当前 PHP 版本下解析依赖失败。
解决办法不是“降级 Rector”，而是换环境安装：
- 用 PHP 8+ 环境（Docker、本地高版本 CLI 或 CI 环境）单独执行
composer require rector/rector --dev - 安装完后，把生成的
vendor/和rector.php配置一起提交进旧项目仓库（PHP 5.6 项目里可以不运行 Rector，只存配置和规则） - 真正执行重构时，必须切换到 PHP 8+ 环境跑
vendor/bin/rector process，旧 PHP 环境只负责存代码，不负责跑工具
如何让 Rector 正确识别 PHP 5 语法并升级到 PHP 8？
Rector 默认按当前运行环境的 PHP 版本解析代码。如果你在 PHP 8 环境下处理 PHP 5 代码，它不会“猜”你想要升什么——得明确告诉它源码是老版本，目标是新版本。
关键靠两个配置项：
立即学习“PHP免费学习笔记（深入）”；
-
parameters.sets加SetList::PHP_80（或PHP_81），表示你要升级到的目标版本 -
parameters.file_extensions必须包含'php'，否则连.php文件都不扫描 - 如果项目里混着
.inc或模板文件，要手动加进去，Rector 默认只认.php
示例片段（rector.php）：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
use Rector\Config\RectorConfig;
use Rector\Set\ValueObject\SetList;
return static function (RectorConfig $rectorConfig): void {
$rectorConfig->paths([
__DIR__ . '/src',
__DIR__ . '/lib',
]);
$rectorConfig->sets([
SetList::PHP_80,
]);
$rectorConfig->fileExtensions(['php']); // 别漏掉这行
};
运行 rector process 时提示 ParseError 或跳过大量文件？
这是最常踩的坑：Rector 用 PHP-Parser 解析代码，而 PHP-Parser 版本和源码 PHP 版本不匹配就会直接报 ParseError: syntax error，比如解析 yield from（PHP 5.5+）时用了太老的 parser，或解析 ??=（PHP 7.4）时 parser 不支持。
根本原因不是 Rector 配置错，而是它底层依赖的 nikic/php-parser 版本不够新。Rector v1.x 自带 parser，但如果你手动锁了低版本依赖，或者用了旧版 Rector（如 0.x），就会出问题。
- 确认 Rector 版本 ≥ 1.0（推荐用最新稳定版：
composer update rector/rector） - 删掉
composer.lock中对nikic/php-parser的手动锁定（尤其"version": "4.15.0"这类老版本） - 加
--debug参数跑一次：vendor/bin/rector process src --debug，看具体哪行报错，再反查是否含 PHP 5 特有语法（如create_function()）还没被规则覆盖
升级后为什么有些函数调用没变，比如 mysql_connect() 还在？
Rector 不自动替换扩展级废弃函数（如 mysql_*、mcrypt_*），因为它无法知道你的替代方案是用 PDO、mysqli 还是第三方库。这类改造属于语义层迁移，不是语法层升级。
它只做三类事：
- 语法结构升级（
list($a, $b) = $arr→[$a, $b] = $arr） - 内置函数签名变更（
array_key_exists($key, $arr)参数顺序不变，但某些函数如strpos()的 strict 模式会被强化） - 类型声明补全（给函数加
: void、参数加string $s）
像 mysql_connect() 这种，得自己写自定义规则，或配合 rector/rector-symfony 等扩展包（如果项目是 Symfony 框架），否则它就当普通函数跳过。
别指望一次跑完所有升级。先用 PHP_80 集合扫基础语法，再人工梳理扩展迁移路径，最后用静态分析工具（如 PHPStan）验证类型一致性。
