Rector升级PHP版本需精准匹配环境：先查php -v和php --modules确认支持的最低版本，再选对应level规则集（如up-to-php81.php），避免混用多个level导致冲突；--dry-run结果与实际差异多因路径配置或文件过滤问题；Web版仅适用于单文件试改，不可替代本地命令行+配置文件+--dry-run闭环流程。
直接用 vendor/bin/rector process 就能跑起来，但盲目执行大概率改出 bug——关键不在“能不能跑”，而在“改什么、怎么验、哪些不能动”。
怎么选对规则集（up-to-php81.php vs level/up-to-php83.php）
PHP 版本升级不是“越高越好”。up-to-php83.php 会强制启用 PHP 8.3 特性（如只读类、#[\Override] 属性），但如果你项目还依赖不兼容的旧扩展（比如某些未更新的 PDO 驱动），或 CI 环境仍跑在 PHP 8.2，就会编译失败。
- 先查当前运行环境：
php -v和php --modules，确认实际支持的最小版本 - 规则集路径是相对的：
__DIR__.'/config/set/level/up-to-php81.php'要确保该文件真实存在（Rector 8.x 默认带 8.0–8.3，但 7.x 不含 8.3） - 别混用多个 level 规则集——
withSets([up-to-php81.php, up-to-php83.php])会导致冲突，Rector 会报Rule conflict: TypeDeclarationForCallLikeRector vs TypedPropertyRector
为什么 --dry-run 显示修改了 127 处，但实际跑完只有 3 处生效
常见原因是路径配置或文件过滤没生效。Rector 默认只处理 .php 文件，且跳过 vendor/、tests/（除非显式加入 withPaths()）。
-
withPaths(['src', 'app'])必须写全，漏掉app/Http/Controllers这类子目录就扫不到 - 如果用了
withSkip()却写成withSkip(['src/Exceptions'])，注意路径必须和磁盘一致——Windows 下反斜杠、Mac/Linux 下正斜杠，Rector 不做归一化 - 某些规则（如
AddArrayReturnTypeRector）需要函数已有完整 docblock 才触发，纯裸函数（function foo() { }）会被跳过
重构后代码报 Fatal error: Uncaught TypeError
这不是 Rector 改错了，而是它暴露了原有类型隐患。典型场景：
- 原代码用
array_merge($a, $b)，但$a实际是null；Rector 加了array返回类型声明，运行时立刻炸 - 构造函数属性提升（
public function __construct(private string $name) {}）要求传参非空，但调用处是new User($_GET['name'] ?? null) - 规则
AddVoidReturnTypeRector给无返回值函数加: void，结果某处写了return $this;—— PHP 8.1+ 会直接 fatal
解决办法：先用 phpstan analyse 或 psalm --no-cache 扫一遍类型问题，再让 Rector 改；或者临时在 withSkip() 里排除高风险类。
Web 版 Rector 能不能替代本地命令行
不能。Web 版适合单文件快速试改（比如粘贴一个控制器看类型声明效果），但有硬限制：
- 不支持自定义规则类，所有逻辑必须来自内置规则集
- 无法读取项目级配置（如
rector.php中的withPaths()或withSkip()） - 不校验命名空间自动导入——
use DateTimeImmutable;不会自动加，DateTimeImmutable::createFromFormat()可能被改成\DateTimeImmutable::createFromFormat()导致类找不到
真正要落地，必须走本地安装 + 配置文件 + --dry-run 三步闭环。Web 版只是探路石，不是生产工具。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
