PHP在数组开头添加元素的方法及array_unshift使用详解

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

在PHP中，如果你想把一个或多个元素添加到数组的最前面，最直接、最常用的函数就是array_unshift()。它会把新元素插入到数组的开头，同时将原数组中的所有元素向后移动。

解决方案

在PHP里，当我们需要把新数据“塞”到数组的第一个位置时，array_unshift()函数就是我们的好帮手。它就像是给数组开了一个“绿色通道”，让新来的元素直接站到队首，而原来排在前面的所有元素，都得乖乖地往后挪一挪。

array_unshift() 的基本用法其实挺直观的：

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

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

1. &$array：这个&符号非常关键。它意味着array_unshift()会直接修改你传入的那个原始数组。它不会给你返回一个新数组，而是“就地”完成操作。所以，如果你不希望原数组被改动，那你就得考虑其他方法了。
2. ...$values：你可以一次性传入一个，也可以传入多个你想要加到数组开头的元素。它们会按照你传入的顺序，从左到右依次被添加到数组的最前面。
3. 返回值：函数会返回修改后数组中元素的总数量。这个值在某些需要即时知道数组大小的场景下，还挺有用的。

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

<?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代码至关重要。

它的“慢”主要原因在于它的工作机制：当你把一个元素插入到数组开头时，PHP不得不把数组中所有现有的元素都往后挪一个位置，为新元素腾出空间。想象一下，如果你的数组里有几万甚至几十万个元素，那么每一次array_unshift()操作，都意味着要执行大量的内存移动和索引重排。这在计算机科学里，我们通常称之为O(n)的时间复杂度，其中n是数组中元素的数量。这意味着，数组越大，操作所需的时间就越长，而且是线性增长。这与array_push()（向数组末尾添加元素）形成鲜明对比，array_push()通常是O(1)或接近O(1)的，因为它只需要在数组末尾追加，通常不需要移动现有元素。

那么，这是否意味着我们应该完全避开array_unshift()呢？倒也不是，关键在于“适用场景”。在我看来，以下几种情况，array_unshift()依然是很好的选择：

1. 处理小型数组：如果你的数组规模不大，比如只有几十个或几百个元素，那么array_unshift()带来的性能开销几乎可以忽略不计。在这种情况下，代码的简洁性和可读性往往比那微小的性能差异更重要。我们没必要为了微小的性能提升，把代码搞得复杂难懂。
2. 特定的逻辑需求：有些时候，业务逻辑就是要求你把最新、最重要的信息放在列表的最前面。比如，你可能在构建一个最近访问历史的列表，或者处理一个需要最新消息优先展示的队列（虽然真正的队列会有更专业的实现）。这时候，array_unshift()的语义表达是最清晰、最符合直觉的。
3. 不频繁的操作：如果你只是偶尔向数组开头添加元素，而不是在一个循环里对一个大数组频繁地执行这个操作，那么它的性能影响通常不会成为瓶颈。

所以，我的建议是，在使用array_unshift()时，心中要有个数：它很方便，但如果你的数组可能变得非常大，并且你需要频繁地在开头添加元素