Добавляем элементы в хвост массива: руководство PHP

Как добавить один элемент с помощью функции array_push?

Функция array_push добавляет переданные элементы в конец массива по ссылке и возвращает новое количество элементов в массиве. Пример для одного элемента:

<?php
$colors = ['red', 'green'];
$newCount = array_push($colors, 'blue');
echo $newCount; // 3
print_r($colors);
?>

3
Array
(
    [0] => red
    [1] => green
    [2] => blue
)

Цель и случаи использования:

Когда нужно не только добавить элемент, но и сразу получить новую длину массива. Однако для одного элемента вызов функции менее эффективен, чем синтаксис []. Рекомендуется использовать array_push только при добавлении нескольких элементов за один раз.

Как добавить несколько элементов одним вызовом?

array_push принимает неограниченное количество аргументов, что удобно для массового добавления:

<?php
$numbers = [1, 2];
array_push($numbers, 3, 4, 5);
print_r($numbers);
?>

Array
(
    [0] => 1
    [1] => 2
    [2] => 3
    [3] => 4
    [4] => 5
)

Цель:

Уменьшить количество операций записи при добавлении нескольких элементов в конец. По производительности это эквивалентно последовательному использованию [], но код становится компактнее.

Как добавить элемент в конец ассоциативного массива с указанием ключа?

Для ассоциативных массивов используется присваивание по ключу: $array['ключ'] = значение. Это добавляет новый элемент или перезаписывает существующий, если ключ уже существует.

<?php
$student = ['name' => 'Иван', 'age' => 20];
$student['city'] = 'Москва';
print_r($student);
?>

Array
(
    [name] => Иван
    [age] => 20
    [city] => Москва
)

Цель:

Добавление элемента с конкретным строковым или числовым ключом. Это основной способ для ассоциативных массивов. Порядок добавления сохраняется (в PHP 7+ сохраняется порядок вставки, а не ключа).

Как добавить массив как вложенный элемент в конец другого массива?

Чтобы вложить один массив в другой (создать многомерную структуру), используются те же методы: $outer[] = $inner или array_push($outer, $inner). Добавленный массив станет элементом внешнего массива с числовым ключом.

<?php
$matrix = [];
$row1 = [1, 2];
$row2 = [3, 4];
$matrix[] = $row1;
array_push($matrix, $row2);
print_r($matrix);
?>

Array
(
    [0] => Array
        (
            [0] => 1
            [1] => 2
        )

    [1] => Array
        (
            [0] => 3
            [1] => 4
        )

)

Цель:

Создание массивов массивов (например, матриц, списков записей). Важно понимать, что добавляется сам массив как элемент, а не его содержимое.

Как объединить два массива, добавив все элементы одного в конец другого?

Для слияния массивов применяется функция array_merge:

<?php
$first = ['a', 'b'];
$second = ['c', 'd'];
$merged = array_merge($first, $second);
print_r($merged);
?>

Array
(
    [0] => a
    [1] => b
    [2] => c
    [3] => d
)

Другие способы слияния:

• Оператор + - добавляет только те ключи из второго массива, которых нет в первом. Для числовых массивов не даёт слияния (сохраняет индексы первого).
• Spread оператор ... (PHP 7.4+): $result = [...$first, ...$second]; - аналогичен array_merge для числовых массивов.

<?php
$first = ['x' => 10, 'y' => 20];
$second = ['y' => 30, 'z' => 40];
// array_merge перезаписывает одинаковые строковые ключи
$mergeResult = array_merge($first, $second);
print_r($mergeResult);
?>

Array
(
    [x] => 10
    [y] => 30
    [z] => 40
)

Цель:

Создание нового массива, содержащего элементы исходных. array_merge переиндексирует числовые ключи, а строковые перезаписываются последним значением. Оператор + не переиндексирует и не перезаписывает существующие ключи.