php 数组插入头部原来这么简单，新手也能快速学会！

发布日期： 2025-10-04 阅读量： 作者： admin

今天就来唠唠我之前捣鼓 PHP 数组，想往数组最前头塞点东西那点事儿。

是这么个情况，有次我从数据库里拉了一串数据，是个列表，要在页面上显示。但是，我想在这个列表的最前面加一个“全部”或者“默认”的选项，方便用户筛选。这数据本身是个数组，PHP 生成的。

我一开始琢磨，往数组里加东西，不是有那个 `array_push()` 吗？试了一下，不对，这玩意儿是往数组屁股后面加的，我要的是加到脑袋前面去。直接用 `$my_array[] = '新东西'` 也不行，也是加到面。

这就有点卡壳了。咋整？不能每次都手动创建一个新数组，把要加的东西放第一个，然后再把原来的数组循环一遍加进去？那也太笨了，效率肯定不行。

我就去翻了翻 PHP 手册，也顺便在网上扒拉了一下别人的经验。果然，PHP 肯定有考虑到这种需求嘛后来我才发现，PHP 自带了一个专门干这事的函数，叫 array_unshift()。

这名字挺形象的，“unshift”，就是“不移位”或者说“往前挪”的意思（我瞎猜的）。它的作用正好就是往数组的开头插入一个或者多个单元。

我的实践过程

找到工具了，那就得试试效果。

我先弄了个简单的数组：

$my_list = ['苹果', '香蕉', '橘子'];

然后，我想在最前面加个“水果总览”。我就这么写：

array_unshift($my_list, '水果总览');

执行完这句，我打印出 $my_list 看了看，结果就变成了：

['水果总览', '苹果', '香蕉', '橘子']

成了！正好是我想要的效果。它不仅把新元素加进去了，还自动把原来的元素往后挪了。

我还试了试一次加俩：

$my_list = ['苹果', '香蕉', '橘子'];
array_unshift($my_list, '分类A', '分类B');

结果是：

['分类A', '分类B', '苹果', '香蕉', '橘子']

也是按我给的顺序插到最前面了，挺好用。

后来我又试了试关联数组（就是带自定义键名的那种）。

$user_info = ['name' => '张三', 'age' => 30];
array_unshift($user_info, 'ID123');

这时候打印出来，结果有点意思：

[0 => 'ID123', 'name' => '张三', 'age' => 30]

它给新加进来的元素自动分配了一个数字键名 0。如果原来数组里就有数字键名？比如：

$original_array = [1 => '第一个', 2 => '第二个'];
array_unshift($original_array, '新来的');

结果是：

[0 => '新来的', 1 => '第一个', 2 => '第二个']

需要注意的是，如果原来的数组是数字索引的，array_unshift() 会重新索引数字键名，总是从 0 开始。但字符串键名它不会动，还是保留原来的。这一点在用的时候得稍微注意一下，如果你后面的代码依赖于原来的数字键名，那用这个函数后可能就对不上了。

还有一种方法，对于关联数组，如果想自己指定插到前面的键名，用数组合并 `+` 操作符也行，像这样：

$new_item = ['id' => 'ID999'];
$user_info = ['name' => '张三', 'age' => 30];
$user_info = $new_item + $user_info;

这样得到的结果是：

['id' => 'ID999', 'name' => '张三', 'age' => 30]

号合并，如果键名不冲突，它会把左边数组的元素放在前面。这也算是一种往头部加关联项的办法。

要在 PHP 数组开头插入元素，最直接、最常用的就是用 array_unshift() 这个函数。用起来很简单，效果也符合预期。就是得留意一下它对数字键名的重新索引行为。如果是处理关联数组，并且想自定义插入的键名，用号合并也是个不错的选择。

好了，今天就分享到这儿，算是我自己实践的一个小记录，希望能帮到有同样需求的哥们儿。