使用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