# array_push

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

array_push — Empile un ou plusieurs éléments à la fin d'un tableau

### Description

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

array_push() considère `array` comme une pile, et empile les variables `values` à la fin de `array`. La longueur du tableau `array` augmente d'autant. Cela a le même effet que :

`<?php
$array[] = $var;
?>`
répété pour chaque valeur.

> Note: Si vous utilisez la fonction array_push() pour ajouter un élément à un tableau, il est préférable de la remplacer par l'opérateur `$array[] =` qui évite le passage par une fonction.

> Note: array_push() émettra une alerte si le premier argument n'est pas un tableau. Ceci diffère du comportement de `$var[]` où un nouveau tableau était créé, antérieurement à PHP 7.1.0.

### Liste de paramètres

`array`

  Le tableau d'entrée.

`values`

  La valeur à insérer à la fin du tableau `array`.

### Valeurs de retour

Retourne le nouveau nombre d'éléments dans le tableau.

### Historique

Version | Description
--- | ---
7.3.0 | Cette fonction peut désormais être appelée avec un seul paramètre. Auparavant, au moins deux paramètres étaient requis.

### Exemples

Exemple #1 Exemple avec array_push()

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

L'exemple ci-dessus va afficher :

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

### Voir aussi

- array_pop() - Dépile un élément de la fin d'un tableau
- array_shift() - Dépile un élément au début d'un tableau
- array_unshift() - Empile un ou plusieurs éléments au début d'un tableau