Добавляет один или несколько элементов в конец массива

# array_push

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

array_push — Добавляет один или несколько элементов в конец массива

### Описание

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

array_push() использует `array` как стек и добавляет переданные значения в конец массива `array`. Длина `array` увеличивается на количество переданных значений. Имеет тот же эффект, что и выражение:

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

повторенное для каждого переданного значения.

> Замечание: Вместо использования array_push() для добавления одного элемента в массив, лучше использовать `$array[] =` , потому что в этом случае не происходит затрат на вызов функции.

> Замечание: array_push() вызовет предупреждение, если первый аргумент не является массивом. Это отличается от поведения конструкции `$var[]` до PHP 7.1.0, в случае которой будет создан новый массив.

### Список параметров

`array`

  Входной массив.

`values`

  Значения, добавляемые в конец массива `array`.

### Возвращаемые значения

Возвращает новое количество элементов в массиве.

### Список изменений

Версия | Описание
--- | ---
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
    )

### Смотрите также

- array_pop() - Извлекает последний элемент массива
- array_shift() - Сдвигает элементы массива влево, выталкивает и возвращает первый элемент
- array_unshift() - Добавляет один или несколько элементов в начало массива

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open