使用 PHP array_unshift 向数组头部插入元素的完整指南

M66 2025-06-10

PHP 中如何将元素插入数组开头？

PHP 是一门功能强大的服务器端脚本语言，广泛用于开发动态网站与应用程序。在处理数组数据时，常常需要将新元素添加到数组的起始位置。此时，array_unshift() 函数便是一个非常实用的工具。

array_unshift 函数的基本用法

array_unshift() 的作用是将一个或多个元素插入到数组的最前面，并返回新的数组长度。其语法如下：

array_unshift(array $array, mixed $value1 [, mixed $value2, ...])

$array：目标数组
$value1, $value2...：要插入的值，可以是一个或多个

示例：插入一个元素到数组开头

下面的示例演示如何使用 array_unshift() 把一个元素添加到数组前面：


<?php
$fruits = array("apple", "orange", "banana");
echo "Before array_unshift:\n";
print_r($fruits);

array_unshift($fruits, "grape");
echo "After array_unshift:\n";
print_r($fruits);
?>

输出结果为：


Before array_unshift:
Array
(
    [0] => apple
    [1] => orange
    [2] => banana
)
After array_unshift:
Array
(
    [0] => grape
    [1] => apple
    [2] => orange
    [3] => banana
)

通过上述代码可以看出，"grape" 被成功插入到了数组的第一个位置。

示例：插入多个元素到数组开头

array_unshift() 同样支持一次性插入多个元素。下面是一个例子：


<?php
$numbers = array(3, 4, 5);
echo "Before array_unshift:\n";
print_r($numbers);

array_unshift($numbers, 1, 2);
echo "After array_unshift:\n";
print_r($numbers);
?>

输出结果为：


Before array_unshift:
Array
(
    [0] => 3
    [1] => 4
    [2] => 5
)
After array_unshift:
Array
(
    [0] => 1
    [1] => 2
    [2] => 3
    [3] => 4
    [4] => 5
)

通过该方法，可以灵活地向数组起始位置添加任意数量的值。

总结

array_unshift() 是 PHP 中一个简洁而强大的数组函数，能够快速将元素插入到数组的开头。无论是单个值还是多个值的插入，都可以轻松实现，避免了手动重建数组的繁琐步骤。在实际开发中，熟练掌握这类函数的使用，将大大提高代码的效率与可维护性。

array_unshift