PHP array_push() 批次新增元素至陣列末尾

array_push() 可一次將多個值推入陣列末尾，自動重新索引數字鍵，回傳新陣列長度。是處理堆疊、佇列、動態收集資料的常用函式。

語法與參數

int array_push(array &$array, mixed ...$values)

• 第一參數為參考傳遞的陣列。
• 後續參數為任意數量的值，依序推入。

程式碼範例

<?php
$alpha = ['a', 'b', 'c'];
$count = array_push($alpha, 'd', 'e');
echo "陣列長度: $count\n"; // 5

foreach ($alpha as $val) {
    echo "$val\n";
}
// 輸出: a b c d e
?>

進階用法

合併另一陣列（需解包）

$arr1 = [1,2];
$arr2 = [3,4];
array_push($arr1, ...$arr2); // PHP 5.6+
// $arr1 = [1,2,3,4]

模擬堆疊

$stack = [];
array_push($stack, 'first', 'second');
$last = array_pop($stack); // 'second'

注意事項

• 僅適用於數字索引陣列；關聯陣列請用 $arr['key'] = $val 或 array_merge。
• 大量資料時，$arr[] = $val 語法效能略優於 array_push()（避免函式呼叫開銷）。
• 回傳值為新長度，非新陣列本身。

簡單高效，是陣列尾部新增元素的標準做法。