Laravel宏中PHP引用传参失效，同逻辑Trait方法可运行是什么原因？

问题根因 #

Laravel 提供的 Macroable trait 是通过 __callStatic 魔术方法处理静态宏调用的，该方法获取参数时依赖的 func_get_args() 函数默认返回参数值的拷贝，不会保留引用属性。即使你在宏闭包的参数声明里写了引用符号，实际接收到的仍然是原数组的副本，修改操作只会作用于副本，不会影响外层的原数组。
你写的普通函数、Trait 方法都是直接声明直接调用，PHP 会严格按照函数声明的传参规则处理，所以引用传参可以正常生效。

解决方案 #

方案一：调整为返回新数组（更符合 Laravel 编码习惯） #

Laravel 官方的 Arr 辅助方法普遍采用不可变设计，返回修改后的新数组而非修改原输入，调整后的代码如下：

Arr::macro('replaceKey', function (string $from, string $into, array $inside) {
    if (! array_key_exists($from, $inside)) {
        throw new Exception("Undefined offset: $from");
    }
    $inside[$into] = $inside[$from];
    unset($inside[$from]);
    return $inside;
});

// 调用示例
$array = Arr::replaceKey('old_key', 'new_key', $array);

方案二：调用时显式传入引用 #

如果确实需要保留无返回值的引用传参设计，调用时主动给参数加上引用符号即可：

// 宏定义保持你原来的写法不变
Arr::replaceKey('old_key', 'new_key', &$arr);

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