# array_push

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

array_push — Inserta uno o más elementos al final de un array

### Descripción

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

array_push() trata `array` como si fuera una pila y coloca la variable que se le proporciona al final del `array`. El tamaño del `array` será incrementado por el número de variables insertados. Tiene el mismo efecto que:

`<?php
$array[] = $var;
?>`
repetido por cada valor proporcionado.

> Nota: Si se utiliza array_push() para añadir un solo elemento al array, es mejor utilizar `$array[] =` ya que de esta forma no existe la sobrecarga de llamar a una función.

> Nota: array_push() generará una advertencia si el primer argumento no es un array. Esto difiere del comportamiento de `$var[]` donde se creará un nuevo array.

### Parámetros

`array`

  El array de entrada.

`value1`

  El primer valor a colocar al final de `array`.

### Valores devueltos

Devuelve el nuevo número de elementos del array.

### Ejemplos

Ejemplo #1 Ejemplo de array_push()

`<?php
$pila = array("naranja", "plátano");
array_push($pila, "manzana", "arándano");
print_r($pila);
?>`

El resultado del ejemplo sería:

    Array
    (
        [0] => naranja
        [1] => plátano
        [2] => manzana
        [3] => arándano
    )

### Ver también

- array_pop() - Extrae el último elemento del final del array
- array_shift() - Quita un elemento del principio del array
- array_unshift() - Añadir al inicio de un array uno a más elementos