array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'en', ), 'this' => array ( 0 => 'function.array-push.php', 1 => 'array_push', ), 'up' => array ( 0 => 'ref.array.php', 1 => 'Array Functions', ), 'prev' => array ( 0 => 'function.array-product.php', 1 => 'array_product', ), 'next' => array ( 0 => 'function.array-rand.php', 1 => 'array_rand', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'en', 'path' => 'reference/array/functions/array-push.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4, PHP 5, PHP 7, PHP 8)
array_push — Push one or more elements onto the end of array
array_push() treats array
as a
stack, and pushes the passed variables onto the end of
array
. The length of array
increases by the number of variables pushed. Has the same effect as:
<?php
$array[] = $var;
?>
Note: If you use array_push() to add one element to the array, it's better to use
$array[] =
because in that way there is no overhead of calling a function.
Note: array_push() will raise a warning if the first argument is not an array. This differed from the
$var[]
behaviour where a new array was created, prior to PHP 7.1.0.
array
The input array.
values
The values to push onto the end of the array
.
Returns the new number of elements in the array.
Version | Description |
---|---|
7.3.0 | This function can now be called with only one parameter. Formerly, at least two parameters have been required. |
Example #1 array_push() example
<?php
$stack = array("orange", "banana");
array_push($stack, "apple", "raspberry");
print_r($stack);
?>
The above example will output:
Array ( [0] => orange [1] => banana [2] => apple [3] => raspberry )