Rector是唯一能基于AST精准识别PHP 8.4静默失效变更的工具，如显式可为空参数、#[\Override]缺失、未使用变量赋值等，避免升级后报错或语义漂移。
PHP 8.4 的破坏性变更不能靠“提前适配”来规避，只能靠“提前识别 + 精准重构”来应对——因为很多变更（如隐式可为空参数弃用、E_STRICT 常量移除）在 8.3 下运行无警告，但升级后直接报错或行为改变。
哪些破坏性变更必须用 Rector 提前扫描
PHP 8.4 官方文档列出的“不向后兼容变更”中，真正需要工具介入的不是语法错误，而是那些静默失效或语义漂移的点。Rector 是目前唯一能基于 AST 精准定位这类问题的工具。
-
ExplicitNullableParamTypeRector：处理function foo(?User $user = null)→function foo(User|null $user = null)。PHP 8.4 不再接受?T作为参数类型，但 8.3 不报错也不警告，靠人工扫几乎必漏 -
AddOverrideAttributeToOverriddenMethodsRector：为所有重写父类 public/protected 方法自动添加#[\Override]。漏加会导致运行时Fatal error: Method must be marked with #[\Override] -
RemoveUnusedVariableAssignRector（来自DeadCode规则集）：PHP 8.4 对未使用变量赋值更严格，某些死代码在 8.3 下被忽略，8.4 中触发Warning: Undefined variable或逻辑跳变
为什么 PHP-CS-Fixer 的 @PHP8x4Migration:risky 不适合主流程适配
这个规则集确实能改掉部分语法，但它属于“文本层替换”，无法理解上下文。比如它会把所有 array 类型声明粗暴替换成 array<mixed></mixed>，但实际项目中你可能需要 array<user></user> 或 array<int string></int> —— 这种语义信息只有 Rector 的 AST 分析能推断出来。
- 它会修改
if ($a == true)→if ($a === true)，看似安全，但在涉及对象比较或自定义__toString()的场景下，==和===行为完全不同 - 它默认启用
modernize_strpos，把strpos($s, 'x') !== false改成str_contains($s, 'x')，但str_contains()在 PHP 8.0+ 才有，如果你项目还要兼容 7.4，这就直接 break build - 它的
risky标签不是虚设：改动前必须vendor/bin/php-cs-fixer fix --dry-run --diff逐行确认，不适合 CI 自动化
真实项目里最常踩的坑：扩展移除 + 钩子语法混用
PHP 8.4 把 Pspell、IMAP、OCI8、PDO_OCI 四个扩展从核心移至 PECL。这不是语法问题，但会导致：
立即学习“PHP免费学习笔记（深入）”；
- 本地开发环境装了
php8.4-imap，CI 流水线用的是官方 Docker 镜像（不含该扩展），class_imap_open直接Fatal error: Uncaught Error: Call to undefined function imap_open() - 属性钩子（
public string $name { get => ...; set { ... } }）和传统 getter/setter 混用时，Rector 默认不处理——它只转纯 getter/setter 方法为钩子，不会帮你删掉旧方法。必须手动确认是否已废弃旧接口，否则出现双写逻辑冲突 -
#[\Deprecated]属性虽是新语法，但 RectorDeprecationRector规则目前仅支持生成注释@deprecated，不生成属性。需额外配置或手写
真正关键的不是“能不能改”，而是“改完是否等价”。比如 get 钩子里抛异常，和原来 getName() 方法抛异常，堆栈深度、错误位置都不同——这些差异不会出现在 --dry-run 输出里，得靠单元测试覆盖兜底。
