Вставка элемента в массив PHP: как это работает под капотом

Вставка элемента в массив в PHP: заглядываем под капот

Представьте: вы пишете на PHP скрипт для интернет-магазина. Пришёл новый товар, и его нужно поставить ровно между «Смартфонами» и «Ноутбуками». Или вы парсите данные и вам нужно вставить строку в середину CSV. Знакомая ситуация? Вопрос «Insert new item in array on any position in PHP» собрал тысячи просмотров на Stack Overflow. И неудивительно: в PHP нет встроенной функции «вставь элемент по индексу». Зато есть мощный инструментарий, который позволяет это сделать красиво и эффективно. Давайте разберёмся, как это работает под капотом.

Почему в PHP нет простой функции insert()?

В отличие от JavaScript (где есть splice()) или Python (list.insert()), PHP-массивы — это гибрид: они одновременно и список, и хеш-таблица. Когда вы вставляете элемент в середину, PHP нужно не просто сдвинуть указатели, а перестроить внутреннюю структуру данных. Именно поэтому разработчики не добавили одноимённый метод, а дали универсальный инструмент — array_splice(). Он решает 99% задач, но важно понимать его «подкапотную» логику.

Самый правильный способ: array_splice()

Это главный герой нашей статьи. Функция array_splice() не только удаляет часть массива, но и может вставлять новые элементы на их место. Причём делает это без создания нового массива — изменения происходят «in place» (по ссылке).

<?php
$fruits = ['apple', 'banana', 'cherry', 'date'];
// Вставляем 'grape' на позицию 2 (после 'banana')
array_splice($fruits, 2, 0, 'grape');
print_r($fruits);
// Результат: ['apple', 'banana', 'grape', 'cherry', 'date']
?>

Синтаксис: array_splice(&$array, $offset, $length, $replacement). Третий параметр ($length) равен нулю — это значит, что мы ничего не удаляем, а просто вставляем. Четвёртый параметр может быть как одним элементом, так и массивом элементов.

Под капотом: Когда вы вызываете array_splice() с нулевой длиной, PHP делает следующее:

• Находит внутренний указатель на позицию $offset.
• Раздвигает массив: все элементы от позиции до конца сдвигаются вправо.
• В освободившееся место вставляет новый элемент (или элементы).
• Переиндексирует числовые ключи (если они были).

Важно: эта операция выполняется за O(n) — чем больше массив и чем ближе вставка к началу, тем больше элементов придётся сдвинуть. Для 99% веб-приложений это незаметно, но если вы работаете с массивами на миллион записей, стоит задуматься об альтернативах.

Вставка нескольких элементов

Хотите вставить сразу три элемента? Просто передайте массив:

<?php
$colors = ['red', 'green', 'blue'];
array_splice($colors, 1, 0, ['yellow', 'purple', 'orange']);
print_r($colors);
// ['red', 'yellow', 'purple', 'orange', 'green', 'blue']
?>

Обратите внимание: массив-вставка не становится вложенным — его элементы «распаковываются» и встают последовательно.

Ручная вставка: когда array_splice не подходит

Иногда нужно сохранить оригинальный массив нетронутым. Или вы хотите вставить элемент без изменения исходных данных. Тут на помощь приходит array_slice() и простое копирование.

<?php
function insertIntoArray(array $original, int $position, mixed $element): array
{
    $before = array_slice($original, 0, $position);
    $after  = array_slice($original, $position);
    return array_merge($before, [$element], $after);
}

$arr = ['a', 'b', 'c', 'd'];
$newArr = insertIntoArray($arr, 2, 'X');
print_r($newArr); // ['a', 'b', 'X', 'c', 'd']
// $arr остался без изменений
?>

Что происходит под капотом? array_slice() создаёт два новых массива — это копирование O(n) памяти. Затем array_merge() сливает их в третий массив. Итог: мы тратим в 2–3 раза больше памяти и времени, чем array_splice(). Зато исходный массив не мутируется.

Вставка с сохранением ключей (ассоциативные массивы)

А что если у вас не список, а ассоциативный массив? array_splice() сбросит числовые ключи, но строковые оставит. Если нужно вставить элемент с конкретным ключом — придётся извращаться:

<?php
$user = [
    'name' => 'John',
    'age' => 30,
    'city' => 'New York'
];

// Хотим вставить 'email' после 'name'
$position = 1; // индекс в порядке элементов
$before = array_slice($user, 0, $position, true);
$after  = array_slice($user, $position, null, true);
$newUser = $before + ['email' => 'john@example.com'] + $after;

print_r($newUser);
/* Результат:
Array
(
    [name] => John
    [email] => john@example.com
    [age] => 30
    [city] => New York
)
*/
?>

Трюк с оператором + работает только с ассоциативными массивами — он не перезаписывает существующие ключи, а добавляет новые слева направо.

Производительность: тест драйв

Давайте посмотрим, что быстрее. Я прогнал простой бенчмарк: вставка элемента в середину массива из 10 000 элементов, 1000 итераций.

Вывод очевиден: array_splice() —