php unshift 函数怎么用？教你轻松在数组开头添加元素！

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

得，今天来说说我捣鼓 `php unshift` 这玩意儿的经历。

事情是这样的，前几天我在写一个小功能，需要处理一个列表数据。这个列表，是个数组，里面放了一堆按顺序排好的任务ID。

遇到个小麻烦

本来，数据是按正常顺序来的，我用循环处理就完事儿了。但中间来了个需求变更，说有时候会有个“加急”的任务插进来，这个任务优先级最高，必须得放到所有任务的最前面去处理。

这就有点意思了。我一开始想着用普通的方法往数组里加元素，比如直接用 `$my_array[] = $new_urgent_task;` 这种，但这样加进去的东西都是默认塞到数组的屁股后头，也就是末尾。

试了试，果然不行，加急任务排到去了，那还叫啥加急。

我就想，PHP这么成熟，肯定有专门处理这种“往数组前面插队”的操作。不能每次都新建一个数组，把新元素放第一个，然后再把旧数组的元素一个个挪过来？那也太笨了。

稍微回忆了一下，加上随手翻了翻文档（就是脑子里过了一遍），想起来有个函数好像就是干这个的，叫 `array_unshift`。

看名字大概也能猜到，`un-shift`，就是跟 `shift`（从前面移走一个）反着来，往前面加东西。

说干就干，我赶紧写了几行代码测试一下。

比如，我本来有这么个数组：

$tasks = ['task_3', 'task_4', 'task_5'];

现在来了个加急任务 `urgent_task_1`。

我就这么用：

array_unshift($tasks, 'urgent_task_1');

然后我打印了一下 `$tasks` 看看结果：

print_r($tasks);

输出结果就变成了：

Array ( [0] => urgent_task_1 [1] => task_3 [2] => task_4 [3] => task_5 )

确实插到最前面去了！ 这就对了嘛

我还顺便试了下，这 `array_unshift` 不光能加一个，还能一次加好几个：

$tasks = ['task_3', 'task_4', 'task_5'];

array_unshift($tasks, 'urgent_task_1', 'urgent_task_2');

print_r($tasks);

结果是：

Array ( [0] => urgent_task_1 [1] => urgent_task_2 [2] => task_3 [3] => task_4 [4] => task_5 )

注意看，它是按照你给的顺序，整体插到前面的。`urgent_task_1` 在参数里是第一个，插进去之后也是第一个。

这个函数还会返回一个整数，就是操作完成后数组里元素的总个数。有时候可能需要这个返回值，但我这回用不上，就没管它。

这回实践挺简单的。`array_unshift` 这函数就是专门用来解决往数组开头添加一个或多个元素的问题。用起来也直接，把数组和要添加的元素传给它就行了。

以后再碰到类似“插队”的需求，就知道用它了，省事儿。