XAMPP PHP 8.1.6使用命名参数报语法错误，但运行无异常

问题场景 #

在PHP 8.1.6环境下，声明了如下函数：

function patch_163_output_row_header(
    string $title,
    string $label,
    $help,
    bool $read_only=false,
    bool $required=false,
    string $label_cell
)

编译该文件无问题，但在另一个文件以命名参数方式调用时：

patch_163_output_row_header(
    title:$title,
    label:$label,
    help:$help,
    read_only:$read_only,
    required:$required,
    label_cell:$label_cell
);

编译检查阶段会在title:行抛出错误：syntax error, unexpected ':', expecting ')'，但实际在同一XAMPP栈中运行代码时无报错，功能也正常。

原因分析 #

• PHP的命名参数语法是PHP 8.0及以上版本才引入的特性
• 这里的“编译报错”并非PHP运行时的编译错误，而是代码编辑器/IDE、静态代码检查工具（如PHPStan、PHPCS）的语法校验功能使用了低于PHP 8.0的版本标准，导致无法识别命名参数语法，从而误报错误。

解决办法 #

• 调整编辑器/IDE的PHP版本配置：将语法检查对应的PHP版本改为8.0或更高（比如匹配你的环境设为8.1）
• 若使用静态代码检查工具，更新工具配置文件，将目标PHP版本指定为8.0+，例如在phpstan.neon或phpcs.xml中设置对应版本参数
• 确认项目composer.json里的config.platform.php设置为8.1.6，避免依赖分析工具误判PHP版本

内容的提问来源于stack exchange，提问作者Dave Torr