PHP原生不支持方法重载，唯一可行路径是__call，仅拦截未定义的实例方法，需在其中手动实现运行时参数分发与类型判断。
PHP 原生不支持方法重载（overload），所谓“重载”必须靠 __call 手动模拟，且仅对未定义的**实例方法**生效，不能用于静态调用或已声明的方法。
为什么 __call 是唯一可行路径
PHP 的函数签名不区分参数类型和数量，编译期就确定方法是否存在。一旦类中定义了 foo()，哪怕带默认参数，再试图用不同参数个数调用它，也不会触发 __call——它只捕获“完全不存在”的方法名。所以真正的“重载”逻辑必须集中到 __call 里做运行时分发。
-
__call不会拦截已定义的 public/protected 方法，哪怕参数不匹配也会直接报ArgumentCountError - 它不处理静态方法，
__callStatic才是对应静态场景的入口 - 方法名大小写敏感，
__call接收到的是实际调用的原始名称（如getData不会自动转成getdata）
用 __call 模拟单方法多签名的典型写法
常见需求是让一个方法名接受不同数量或类型的参数，比如 set() 支持 set($key, $value) 和 set(array $data)。核心是检查 $arguments 的结构，而非硬编码分支：
public function __call($name, $arguments)
{
if ($name === 'set') {
if (count($arguments) === 2 && is_string($arguments[0])) {
return $this->setSingle($arguments[0], $arguments[1]);
}
if (count($arguments) === 1 && is_array($arguments[0])) {
return $this->setBatch($arguments[0]);
}
throw new InvalidArgumentException('Invalid arguments for set()');
}
throw new BadMethodCallException("Call to undefined method {$name}");
}
- 不要用
func_num_args()或func_get_args()，它们在__call中不可靠 - 优先用
is_array()、is_string()等类型判断，而非gettype()（返回字符串易出错） - 明确抛出
BadMethodCallException，避免静默失败；PHP 内部错误（如参数太少）会抛ArgumentCountError，但那是你没兜住的情况
容易踩的坑：参数转发与引用丢失
如果想把参数原样传给内部方法（比如统一委托给 handle()），直接写 $this->handle(...$arguments) 看似简洁，但会破坏引用传递语义——PHP 7.4+ 的展开操作符 ... 总是按值传递，即使原参数是引用。
立即学习“PHP免费学习笔记（深入）”；
- 若被调用方法需修改传入变量（如
function process(&$data)），不能用...展开，得手动逐个传参或改用数组封装 -
__call中的$arguments是副本，修改它不影响原始调用上下文 - 性能上，
__call比直接调用慢 3–5 倍（实测），高频调用场景应避免过度依赖
替代方案比 __call 更合适的情况
不是所有“想重载”的场景都该用 __call。例如：
- 构造器参数差异大？用静态工厂方法：
User::fromArray($data)、User::fromId($id) - 只是可选参数多？用数组配置 + 默认值：
search(['query' => 'php', 'limit' => 10]) - 需要类型安全？PHP 8+ 的联合类型 + 参数解构更直接：
function process(string|int $id, ?string $name = null)
真正需要 __call 的，通常是 DSL 风格接口（如 ORM 的 whereNameAndAge() 动态方法）或兼容旧代码的胶水层。它本质是妥协方案，不是设计首选。
