array_push

(PHP 4, PHP 5, PHP 7, PHP 8)

array_push — 將一個或多個單元壓入陣列的末尾（入棧）

array_push(array &$array, mixed $value1, mixed $... = ?): int

array_push() 將 array 當成一個棧，並將傳入的變數壓入 array 的末尾。array 的長度將根據入棧變數的數目增加。和如下效果相同：


<?php
$array[] = $var;
?>

並對每個傳入的值重複以上動作。

注意: 如果用 array_push() 來給陣列增加一個單元，還不如用 $array[] = ，因為這樣沒有呼叫函式的額外負擔。

注意: 如果第一個參數不是陣列，array_push() 將發出一條警告。這和 $var[] 的行為不同，在 PHP 7.1.0 之前的版本中，後者將會新建一個陣列。

返回處理之後陣列的元素個數。

版本	說明
7.3.0	可以只用一個參數來呼叫此函式，之前版本中至少需要兩個參數。

示例 #1 array_push() 例子


<?php
$stack = array("orange", "banana");
array_push($stack, "apple", "raspberry");
print_r($stack);
?>

以上例程會輸出：

Array
(
    [0] => orange
    [1] => banana
    [2] => apple
    [3] => raspberry
)