PHP怎样通过array_unshift插入对象-php教程-PHP中文网

array_unshift能插入对象是因为php数组支持混合类型，对象作为普通值被 prepend 到开头；它不区分数据类型，仅将传入参数（含对象）按顺序插入，数值键重索引，关联键保留，且操作直接修改原数组并返回新长度。

php怎样通过array_unshift插入对象

array_unshift 为什么能插入对象

array_unshift 本身不区分数据类型，它只是把传入的值（无论 int、string 还是对象）作为新元素 prepend 到数组开头。PHP 数组是混合类型的，对象被当作普通值处理——只要不是资源或某些特殊结构（如不可序列化的闭包），就能正常插入。

常见错误现象：array_unshift 返回整数（新数组长度），但有人误以为它返回修改后的数组，结果写成 $arr = array_unshift($arr, $obj)，导致 $arr 变成数字，原数组丢失。

必须直接操作原数组，不要赋值给变量
对象插入后，数组中存储的是该对象的引用（PHP 7.4+ 对象默认按引用传递，但数组内仍是对象标识符，修改对象属性会影响所有持有该对象的变量）
如果对象实现了 __sleep 或 __wakeup，且后续会序列化数组，需确认其兼容性

插入单个对象的正确写法

最简场景：往已有数组头部加一个对象实例。

$user = new stdClass();
$user->name = 'Alice';

$users = [['id' => 1, 'name' => 'Bob']];
array_unshift($users, $user); // ✅ 正确：直接修改 $users

// 结果：$users[0] 是对象，$users[1] 是关联数组
var_dump($users[0]->name); // string(5) "Alice"

注意：array_unshift 支持多个参数，可一次插入多个对象或混合类型：

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

array_unshift($arr, $obj1, $obj2, 'string', 42) 合法
顺序严格按参数位置，$obj1 成为索引 0，$obj2 成为索引 1，依此类推
若原数组是关联键名（如 ['a' => ...]），array_unshift 仍会重置数字索引，但保留原有键名不变 —— 新增元素总是获得数字键 0,1,2…

与 array_merge 的关键区别

有人想“在开头插入对象”却误用 array_merge([ $obj ], $arr)，这在多数情况下也能得到类似结果，但行为不同：

array_unshift 修改原数组，返回新长度（int），无额外内存拷贝（就地操作）
array_merge 创建新数组，原数组不变；若 $arr 是数值索引，结果也是数值索引；但若 $arr 是关联数组（键非数字），array_merge 会合并键名，可能覆盖或重排
性能上，array_unshift 对大数组较慢（O(n) 时间移动所有元素），而 array_merge 也是 O(n)，但多一次分配；两者都不适合高频插入场景

真正需要“不可变式插入”时才选 array_merge；日常就地修改，坚持用 array_unshift 更直观、更省内存。