Как вставить новый элемент в массив на любую позицию в PHP?

Использование array_splice() для вставки элемента в произвольную позицию

В PHP нет встроенной функции array_insert(), но задача решается очень элегантно с помощью array_splice(). Эта функция изначально предназначена для удаления части массива, но если передать в качестве заменяющего элемента новый элемент, она вставит его без удаления.

Вот как это работает:

<?php
$users = ['Анна', 'Борис', 'Виктор'];

// Вставляем 'Глеб' после второго элемента (индекс 1)
array_splice($users, 2, 0, 'Глеб');

print_r($users);
// Результат: Array ( [0] => Анна [1] => Борис [2] => Глеб [3] => Виктор )
?>

Как это работает:

• Первый параметр — массив, который мы модифицируем (передаётся по ссылке).
• Второй параметр — индекс, с которого начинаем. В нашем случае 2 — это позиция, куда вставится новый элемент (после элемента с индексом 1).
• Третий параметр — количество удаляемых элементов. 0 означает, что ничего не удаляем.
• Четвёртый параметр — значение, которое вставляется.

Если нужно вставить несколько элементов, можно передать массив:

<?php
$users = ['Анна', 'Борис', 'Виктор'];

// Вставляем два новых имени
array_splice($users, 2, 0, ['Глеб', 'Дарья']);

print_r($users);
// Результат: Array ( [0] => Анна [1] => Борис [2] => Глеб [3] => Дарья [4] => Виктор )
?>

Универсальная функция для вставки

Чтобы было удобнее, можно создать свою функцию-обёртку:

<?php
function array_insert(&$array, $position, $value) {
    array_splice($array, $position, 0, $value);
}

$users = ['Анна', 'Борис', 'Виктор'];
array_insert($users, 2, 'Глеб');
print_r($users);
// Результат: Array ( [0] => Анна [1] => Борис [2] => Глеб [3] => Виктор )
?>

Важные замечания:

• array_splice() модифицирует исходный массив, а не возвращает новый.
• Если указать позицию больше длины массива, элемент будет добавлен в конец.
• Для ассоциативных массивов array_splice() работает, но сбрасывает ключи на числовые. Если нужно сохранить строковые ключи, лучше использовать другой подход.

Этот метод считается стандартным в PHP и используется в большинстве реальных проектов. Он эффективен и не требует ручного разбиения массива.

<?php
$users = ['Анна', 'Борис', 'Виктор'];
$position = 2; // вставляем после второго элемента
$newItem = 'Глеб';

$result = array_merge(
    array_slice($users, 0, $position),
    [$newItem],
    array_slice($users, $position)
);

print_r($result);
// Результат: Array ( [0] => Анна [1] => Борис [2] => Глеб [3] => Виктор )
?>