如何在PHP中向数组开头添加元素？array_unshift()的实现方法

使用array_unshift()可将元素添加到数组开头，它直接修改原数组并返回新长度，适用于小型数组或不频繁操作，但因需移动所有元素，处理大型数组时性能较差。

在PHP中，如果你想把一个或多个元素添加到数组的最前面，最直接、最常用的函数就是

array_unshift()

解决方案

在PHP里，当我们需要把新数据“塞”到数组的第一个位置时，

array_unshift()

array_unshift()

array_unshift(array &$array, mixed ...$values): int

这里有几个点，我觉得特别值得你留意：

立即学习“PHP免费学习笔记（深入）”；

1. &$array

   ：这个

   &

   符号非常关键。它意味着

   array_unshift()

   会直接修改你传入的那个原始数组。它不会给你返回一个新数组，而是“就地”完成操作。所以，如果你不希望原数组被改动，那你就得考虑其他方法了。

2. ...$values

   ：你可以一次性传入一个，也可以传入多个你想要加到数组开头的元素。它们会按照你传入的顺序，从左到右依次被添加到数组的最前面。
3. 返回值：函数会返回修改后数组中元素的总数量。这个值在某些需要即时知道数组大小的场景下，还挺有用的。

我们来看几个具体的例子，这样理解起来会更清晰：

Cursor

一个新的IDE，使用AI来帮助您重构、理解、调试和编写代码。

下载

<?php
// 示例1：向数字索引数组开头添加一个元素
$fruits = ['apple', 'banana'];
echo "原始数组: ";
print_r($fruits);

array_unshift($fruits, 'orange');
echo "添加一个元素后: ";
print_r($fruits);
// 输出: Array ( [0] => orange [1] => apple [2] => banana )

echo "--------------------\n";

// 示例2：向数字索引数组开头添加多个元素
$numbers = [3, 4, 5];
echo "原始数组: ";
print_r($numbers);

array_unshift($numbers, 1, 2);
echo "添加多个元素后: ";
print_r($numbers);
// 输出: Array ( [0] => 1 [1] => 2 [2] => 3 [3] => 4 [4] => 5 )

echo "--------------------\n";

// 示例3：向关联数组开头添加元素
// 注意：新元素会获得数字键，原有关联键保持不变，可能导致数组变为混合类型
$data = ['b' => 'banana', 'c' => 'cherry'];
echo "原始关联数组: ";
print_r($data);

array_unshift($data, 'apple');
echo "添加元素到关联数组后: ";
print_r($data);
// 输出: Array ( [0] => apple [b] => banana [c] => cherry )
// 这里'apple'得到了数字键0，而'b'和'c'这些关联键则保持原样。
// 如果你的数组原本是纯关联的，这操作后它就变成了一个混合数组。
?>

从这些例子里，我们能看出来

array_unshift()

array_unshift() 的性能开销与适用场景是什么？

说实话，

array_unshift()

它的“慢”主要原因在于它的工作机制：当你把一个元素插入到数组开头时，PHP不得不把数组中所有现有的元素都往后挪一个位置，为新元素腾出空间。想象一下，如果你的数组里有几万甚至几十万个元素，那么每一次

array_unshift()

array_push()

array_push()

那么，这是否意味着我们应该完全避开

array_unshift()

array_unshift()

1. 处理小型数组：如果你的数组规模不大，比如只有几十个或几百个元素，那么

   array_unshift()

   带来的性能开销几乎可以忽略不计。在这种情况下，代码的简洁性和可读性往往比那微小的性能差异更重要。我们没必要为了微小的性能提升，把代码搞得复杂难懂。
2. 特定的逻辑需求：有些时候，业务逻辑就是要求你把最新、最重要的信息放在列表的最前面。比如，你可能在构建一个最近访问历史的列表，或者处理一个需要最新消息优先展示的队列（虽然真正的队列会有更专业的实现）。这时候，

   array_unshift()

   的语义表达是最清晰、最符合直觉的。
3. 不频繁的操作：如果你只是偶尔向数组开头添加元素，而不是在一个循环里对一个大数组频繁地执行这个操作，那么它的性能影响通常不会成为瓶颈。

所以，我的建议是，在使用

array_unshift()