PHP数组赋值异常：order_number字段前置时值为null的原因排查

我最近写了一段PHP代码，定义了createAdminTask方法，参数是$key和$val，结果遇到了一个离谱的情况：

异常代码场景 #

/**
 * 
 * @param string $key
 * @param string $val
 */
public function createAdminTask($key, $val) {
    $request_body = [
        "order_number" => $val,
        "order_id" => null,
        "prescription_id" => null,
        "payer_id" => null,
        "card_id" => null,
        "prescription_key" => null,
    ];
    dd($val,$request_body);
}

用dd调试时，$val能正常显示（比如输出"Y81383124932"），但$request_body里的order_number字段却变成了null，调试结果如下：

"Y81383124932"
array:9 [▼
  "order_number" => null
  "order_id" => null
  "prescription_id" => null
  "payer_id" => null
  "card_id" => null
  "prescription_key" => null
]

调整后正常的场景 #

但我把order_number移到数组最后之后，一切就正常了，代码改成这样：

$request_body = [
    "order_id" => null,
    "prescription_id" => null,
    "payer_id" => null,
    "card_id" => null,
    "prescription_key" => null,
    "order_number" => $val,
];

此时调试输出里的order_number就能正确获取$val的值了：

"Y81383124932"
array:9 [▼
  "order_id" => null
  "order_number" => "Y81383124932"
  "prescription_id" => null
  "payer_id" => null
  "card_id" => null
  "prescription_key" => null
]

问题原因分析 #

首先可以明确：这绝对不是PHP原生数组赋值的缓存机制导致的，PHP数组的元素顺序不会影响变量的赋值结果。出现这种怪异现象，大概率是下面几个原因：

• 数组被隐性修改/覆盖：注意到两次调试输出的数组都是array:9，但你定义的数组只有6个元素！这说明有额外3个元素被偷偷添加到数组里了，甚至可能存在order_number被后续代码覆盖的情况。比如有没有框架中间件、全局钩子，或者当前类的父类/trait里的代码，在你定义数组之后、dd之前修改了这个数组？当你把order_number移到最后，修改数组的代码可能没覆盖最后添加的元素，所以值保留了下来。

• 调试工具的显示bug：有时候dd（尤其是Laravel等框架里的dd）或者IDE的调试面板可能会出现显示异常，比如缓存了之前的数组状态。可以换用原生的var_dump($val, $request_body)或者print_r来验证输出的真实性。

• 变量引用或魔术方法干扰：如果$val是通过引用传递的参数（比如方法定义是createAdminTask($key, &$val)），有没有可能在数组定义后被其他代码修改？另外，如果当前类继承了父类或使用了trait，要检查是否存在__set、__get这类魔术方法，或者数组重载逻辑，干扰了数组元素的存储。

排查建议 #

• 检查数组真实元素：在dd前添加echo count($request_body);，确认数组的实际元素数量，找出额外的3个元素是什么，追踪它们的来源。
• 换用原生调试函数：用var_dump代替dd，排除调试工具的显示问题。
• 隔离变量：把$val赋值给临时变量$temp = $val;，然后数组里用$temp，看结果是否一致，排除$val被引用修改的可能。
• 检查类的继承关系：查看当前类的父类、使用的trait，有没有会修改数组的魔术方法或钩子逻辑。

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