array_push

Push one or more elements onto the end of array

&reftitle.description; `int` `array_push` `array` `array` `mixed` `values`

`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;
    ?>

repeated for each passed value.

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.

`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.

&reftitle.parameters;

`array`

- The input array.

`values`

- The values to push onto the end of the `array`.

&reftitle.returnvalues;

Returns the new number of elements in the array.

&reftitle.changelog;

&Version; | &Description;
7.3.0 | This function can now be called with only one parameter. Formerly, at least two parameters have been required.

&reftitle.examples;

### `array_push` example

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

&example.outputs;

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

&reftitle.seealso;

- `array_pop`
- `array_shift`
- `array_unshift`