array_unshift 是 php 唯一原生、安全、语义明确的在数组开头插入元素的方式，修改原数组并返回新长度，索引数组重排键名、关联数组保留键名。
用 array_unshift 往 PHP 数组开头加元素
直接说结论：array_unshift 是 PHP 唯一原生、安全、语义明确的「在数组开头插入一个或多个元素」的方式。它会修改原数组，返回新长度，不改变键名（索引数组会重排，关联数组键名保留）。
常见错误是拿 array_merge 或 [] = 模拟——前者开销大，后者可能意外覆盖键名或破坏顺序。
-
array_unshift($arr, 'a', 'b')：一次插多个，顺序严格从左到右，'a'最先出现在开头 - 对空数组也安全，不会报错
- 传入引用数组时注意副作用：
array_unshift直接改原数组，别指望它返回副本
array_unshift 和 array_push 的行为差异
两者都是“就地修改”，但方向相反；关键区别不在功能，而在性能和适用场景：
-
array_push底层优化好，追加几乎常数时间；array_unshift需要整体平移所有元素，时间复杂度是 O(n)，大数据量时明显变慢 - 如果频繁在开头插入，考虑是否该用
SplStack或反转逻辑：改为array_push+ 最后array_reverse（仅当插入完成才反转） - 索引数组插入后，数字键会被强制重编号（0,1,2……），但关联键（如
'name' => 'x'）不受影响
遇到 Warning: array_unshift() expects at least 2 parameters
这是最常踩的坑：少传了要插入的值。函数签名是 array_unshift(array &$array, mixed ……$values)，第一个参数必须是变量（且可写），不能是表达式或函数调用结果。
立即学习 “PHP 免费学习笔记（深入）”；
- ❌ 错误写法：
array_unshift(get_array(), 'x')——get_array()返回的是临时数组，无法引用修改 - ❌ 错误写法：
array_unshift($arr + ['y' => 1], 'x')—— 右侧是表达式，不是变量 - ✅ 正确写法：
$arr = get_array(); array_unshift($arr, 'x'); - 注意：PHP 7.4+ 支持尾逗号，但不影响参数个数校验
想保持键名又插开头？别硬刚 array_unshift
array_unshift 对关联数组虽然不删键，但会把新元素塞进数字索引 0，老元素往后挤，导致混合键名混乱。真要“保持全部键名并前置”，得手动重组：
$new = ['first' => 'x'] + $arr; 但注意：+ 是 ** 左优先合并 **，只在键不存在时才加入右边；如果 $arr 里有 'first'，这个操作会静默丢掉你新加的值。更稳妥的是：
- 用
array_merge(['first' => 'x'], $arr)—— 强制重排索引，适合需要纯数字键的场景 - 若必须保留所有键且避免覆盖，先检查：
if (!array_key_exists('first', $arr)) {$arr = ['first' => 'x'] + $arr; }
这种需求本身往往暴露了数据结构设计问题：开头固定字段，可能更适合拆成独立变量或对象属性，而不是硬塞进数组头部。
