PHP 8.0 命名参数要求位置参数必须全部在命名参数之前，否则触发 ParseError；混合调用如 foo($a, email: $b) 非法，而 foo(email: $b, name: $a) 或 foo($a, $b) 合法。
PHP 8.0 并没有引入新的“大括号写法”，你实际想处理的，是 PHP 8.0+ 中命名参数（named arguments）调用时，因混用位置参数与命名参数导致语法错误，或旧代码中函数调用被误判为需要加括号/大括号的场景——这类问题在自动重构时最容易出错。
为什么 foo($a, $b) 突然报错？命名参数不是加括号的事
常见误解：以为 PHP 8.0 强制要求函数调用必须用大括号或新语法。实际是——只要你在调用中用了命名参数（如 foo(name: $x, email: $y)），就必须遵守规则，否则会直接 Parse Error。
-
Parse error: syntax error, unexpected ':'：说明 PHP 版本低于 8.0，或启用了不兼容的 SAPI 模式（如某些旧版 CLI 配置未加载 PHP 8.0 解析器） - 混合使用位置和命名参数（如
foo($a, email: $y)）会报Cannot use positional argument after named argument - 匿名函数定义中用命名参数（
fn(name: $x) => $x）在 PHP 8.0 是非法的，只支持fn($x) => $x；命名参数仅用于「调用」，不用于「定义」
用 php-parser 安全识别并替换函数调用
手动全局搜索替换 foo( → foo( 是无效的。真正要改的是调用上下文中的参数结构。AST 才能区分：foo($a, $b) 是普通调用，而 foo($a, email: $b) 是命名参数调用且含风险。
- 用
PhpParser\Node\Expr\FuncCall节点判断是否含Name类型的Arg（即name: $val形式） - 若发现混合调用（
Arg列表中前几个是Arg实例、后一个是Arg带$arg->name !== null），需整体重写为全命名或全位置形式 - 不要用字符串正则去匹配
email:——它可能出现在注释、字符串、甚至变量名里（如$email_colon = ":"）
重构时最常踩的三个坑
很多团队用 Rector 或自写脚本批量升级，结果上线后部分接口 500，原因往往就在这三处：
立即学习“PHP免费学习笔记（深入）”；
- 第三方库函数签名变更但未同步更新调用方，例如
Illuminate\Support\Str::of()在 Laravel 10+ 接受命名参数，但旧版不支持，AST 无法自动感知框架版本约束 -
func_get_args()和func_get_arg()在命名参数调用下仍返回位置顺序数组，但开发者误以为能拿到键名，导致逻辑错乱 - 动态函数名调用（
$fn = 'foo'; $fn(...$args)）无法被 AST 静态分析识别是否含命名参数，这类必须人工 review 或加运行时断言
真正的难点不在语法转换，而在语义一致性：一个函数调用是否该转成命名参数，取决于它所在上下文的可读性收益和协作约定。强行全量替换，反而会让团队更难定位哪一行改坏了逻辑。
