PHP混合调用参数时，位置参数必须全部前置且连续，之后才能跟命名参数；否则因解析歧义抛出ParseError，推荐统一使用命名参数以提升可维护性。
可以混合使用，但有严格限制：位置参数必须全部放在命名参数之前，不能穿插或颠倒。
混合使用的合法写法
PHP 解析器要求所有位置参数必须连续出现在最前面，之后才能跟命名参数。只要满足这个结构，就是合法的。
- func(1, 2, name: 'Alice', age: 30) —— 合法：两个位置参数在前，两个命名参数在后
- func(name: 'Alice', age: 30) —— 合法：纯命名，顺序完全自由
- func(1, name: 'Alice') —— 合法：一个位置 + 一个命名
常见非法写法及报错原因
一旦命名参数后面出现位置参数，PHP 就无法确定该值该赋给哪个参数，直接抛出 ParseError。
PHP 8.5.12
下载
修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
- func(name: 'Alice', 30) —— 错误：命名后接位置参数，语法不被接受
- func(1, name: 'Alice', 30) —— 错误：第二个位置参数出现在命名参数之后
- func(name: 'Alice', role: 'admin', 30) —— 错误：同上，解析器拒绝继续匹配
为什么必须这样设计
PHP 需要明确区分“按序绑定”和“按名绑定”两个阶段。位置参数从左到右依次填充函数签名中尚未被命名覆盖的参数；一旦开始命名，后续就只能靠名字定位——不允许再切换回位置模式，否则语义模糊。
立即学习“PHP免费学习笔记（深入）”；
- 函数定义为
function greet($greeting, $name, $punct = '!') -
greet('Hi', name: 'Bob')→$greeting='Hi',$name='Bob',$punct用默认值 - 若写成
greet(name: 'Bob', 'Hi')，PHP 不知道'Hi'是想覆盖$greeting还是$punct
实际开发建议
为减少出错和提升可维护性，推荐优先采用统一风格。
- 团队项目中明确约定：新函数调用尽量用全命名参数
- 遗留代码改造时，若需混合，确保位置参数仅用于最左侧几个高频必填项（如 ID、名称）
- IDE 和静态分析工具（如 PHPStan）通常能提前标出非法混合写法，建议开启相关检查
