PHPTime

Как добавить и удалить элемент массива в PHP

В PHP способ добавления и удаления элементов зависит от того, как используются ключи. Для списка обычно важен порядок и непрерывная нумерация, а для ассоциативного массива — сохранение ключей. Разберём обе ситуации и покажем, как получить первый и последний элементы.

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

Массив PHP — упорядоченное отображение с целочисленными или строковыми ключами. Список — частный случай: его ключи идут от 0 до count($array) - 1 в порядке обхода. Чтобы добавить один элемент в конец списка, используйте $array[] = $value. Для записи по известному ключу используйте $array[$key] = $value.

PHP
$tasks = ['Проверить заявку'];
$tasks[] = 'Отправить ответ'; // Новый элемент с ключом 1

$options = ['locale' => 'ru'];
$options['timezone'] = 'Europe/Moscow'; // Новый ключ
$options['locale'] = 'en'; // Замена значения по существующему ключу

Автоматический ключ зависит от истории числовых ключей массива. Например, после unset($items[2]) в массиве [0 => 'a', 1 => 'b', 2 => 'c'] следующая запись через [] получит ключ 3. Пропуск с ключом 2 останется. Пример различия версий: для только что созданного массива [-5 => 'a'] добавление через [] в PHP 8.3–8.5 даст ключ -4, а в PHP 8.2 даст 0.

Проверяйте тип ключа, если он приходит извне. Строка '8' становится целочисленным ключом 8, поэтому запись по одному из этих ключей заменит запись по другому. Строка '08' сохраняется как отдельный строковый ключ.

Как добавить в массив несколько элементов или вставить их в начало

array_push() добавляет переданные значения в конец и возвращает новое количество элементов. array_unshift() вставляет значения в начало, возвращает количество элементов и перенумеровывает все числовые ключи с нуля. Строковые ключи сохраняются.

PHP
$queue = ['обычная задача'];
$total = array_push($queue, 'проверка', 'отчёт'); // 3 элемента
array_unshift($queue, 'срочная задача'); // Теперь 4 элемента

Для вставки в середину списка подходит array_splice(). Второй аргумент задаёт позицию в порядке обхода, третий — количество удаляемых элементов. При нулевой длине функция только вставляет значения. Числовые ключи исходного массива переиндексируются, а ключи вставляемого массива отбрасываются.

PHP
$steps = ['получить заявку', 'ответить'];
array_splice($steps, 1, 0, ['проверить данные']);
// $steps: ['получить заявку', 'проверить данные', 'ответить']

Все три функции меняют переданный массив. Частая ошибка — писать $queue = array_push($queue, $item): переменная получит число. Если нужно получить новый массив из двух списков, подойдёт $all = [...$first, ...$second]. Для массивов со строковыми ключами распаковка также работает: при совпадении ключа побеждает значение из более позднего массива, а числовые ключи перенумеровываются.

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

Когда известен ключ, используйте unset($array[$key]). Остальные ключи и порядок обхода сохраняются. Удаление отсутствующего ключа безопасно, а удалённое значение unset() не возвращает.

PHP
$items = ['чай', 'кофе', 'вода'];
unset($items[1]); // [0 => 'чай', 2 => 'вода']

$list = array_values($items); // [0 => 'чай', 1 => 'вода']

array_values() возвращает новый список, отбрасывая все исходные ключи. Это полезно перед json_encode(), если получателю нужен JSON-массив: PHP-массив с ключами 0 и 2 будет закодирован как JSON-объект. Проверить структуру можно функцией array_is_list(). У массива с пропуском она вернёт false, у пустого массива — true.

Когда известна позиция, используйте array_splice($items, $offset, 1). Смещение отсчитывается с нуля в порядке обхода, поэтому позиция 1 у массива с ключами 10 и 20 соответствует ключу 20. Функция меняет исходный массив, переиндексирует его числовые ключи и возвращает массив удалённых элементов.

PHP
$items = [10 => 'чай', 20 => 'кофе', 30 => 'вода'];
$removed = array_splice($items, 1, 1);
// $removed: ['кофе'], $items: ['чай', 'вода']

Как удалить первый или последний элемент

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

Как удалить элемент массива по значению

Чтобы удалить первое совпадение, найдите ключ через array_search() и передайте его в unset(). Используйте третий аргумент true для строгого сравнения и проверяйте результат через !== false. Ключ 0 — корректный результат, хотя обычная проверка if ($key) его пропустит.

PHP
$ids = [42, '42', 42, 17];
$key = array_search(42, $ids, true);
if ($key !== false) {
    unset($ids[$key]); // Удаляем первое целое 42 по ключу 0
}

Для удаления всех совпадений удобно вернуть новый массив через array_filter(). Фильтр сохраняет ключи. Если результат нужен как список, добавьте array_values().

PHP
$ids = [42, '42', 42, 17];
$filtered = array_filter($ids, static fn (mixed $id): bool => $id !== 42);
$list = array_values($filtered); // ['42', 17]

array_filter($array) без callback удаляет все значения, которые приводятся к false, включая 0, '0', false, null и пустую строку. Для удаления конкретного значения задавайте условие явно. declare(strict_types=1) не меняет правила операторов сравнения и не включает строгий режим в array_search().

Как получить первый и последний элемент массива в PHP

Для массива с произвольными ключами используйте array_key_first() и array_key_last(), затем прочитайте значения по найденным ключам. Эти функции работают в порядке обхода массива, возвращают null для пустого массива и сохраняют положение внутреннего указателя.

PHP
$prices = ['basic' => 0, 'pro' => 990, 'trial' => null];
$firstKey = array_key_first($prices); // 'basic'
$lastKey = array_key_last($prices); // 'trial'

if ($firstKey !== null && $lastKey !== null) {
    $first = $prices[$firstKey]; // 0
    $last = $prices[$lastKey]; // null, элемент существует
}

Для гарантированного списка можно обратиться к $items[0] и $items[count($items) - 1], предварительно проверив, что список непустой. Если ключи могли разойтись после unset() или фильтрации, используйте функции для получения крайних ключей. Операторы isset($items[$key]) и ?? одинаково трактуют отсутствующий ключ и значение null. Функция array_key_exists() позволяет различить эти случаи.

PHP 8.5: функции array_first() и array_last()

В PHP 8.5 появились array_first() и array_last(). Они сразу возвращают крайние значения в порядке обхода массива, не меняя его и не сдвигая внутренний указатель. В PHP 8.3 и 8.4 для совместимого кода используйте array_key_first() и array_key_last().

PHP
<?php

declare(strict_types=1);

// PHP 8.5 и новее
function firstLabel(array $labels): ?string
{
    return array_first($labels);
}

$labels = ['start' => 'черновик', 'finish' => 'готово'];
$first = firstLabel($labels); // 'черновик'
$last = array_last($labels); // 'готово'

Обе новые функции возвращают null для пустого массива. Если null допустим и как значение крайнего элемента, проверьте $array === [] либо сначала получите крайний ключ.

PHP reset() и end(): как работает внутренний указатель

reset($array) переводит внутренний указатель на первый элемент и возвращает его значение. end($array) переводит указатель на последний элемент и возвращает его значение. После вызова key($array) возвращает ключ текущего элемента, а current($array) — его значение. Обычный foreach обходит массив независимо от этого указателя.

PHP
$flags = ['enabled' => true, 'archived' => false];
$first = reset($flags); // true
$last = end($flags); // false — значение элемента
$lastKey = key($flags); // 'archived'

У пустого массива обе функции тоже возвращают false. Даже проверка end($array) === false не различит пустой массив и последний элемент со значением false. Проверьте $array === [] до вызова или используйте key() сразу после него: для пустого массива ключ будет null.

Функции принимают массив по ссылке, поэтому передавайте переменную. Например, для reset(array_values($items)) промежуточный результат сначала нужно присвоить переменной. В PHP 8.3–8.5 передача объекта в reset() или end() считается устаревшей начиная с PHP 8.1. Для объекта используйте его интерфейс обхода или сначала получите нужные данные в виде массива.

Чек-лист для работы с массивами в PHP 8.3–8.5

  • Добавить одно значение в конец — $array[] = $value. Записать значение под заданным ключом — $array[$key] = $value.
  • Удалить по ключу с сохранением остальных ключей — unset(). Удалить по позиции с перенумерацией числовых ключей — array_splice().
  • Удалить первое совпадение по значению — array_search($value, $array, true) и проверка !== false. Удалить все совпадения — array_filter() с явным условием.
  • Проверить, что результат остался списком, — array_is_list(). Собрать список из значений — array_values().
  • Прочитать крайние элементы без сдвига указателя — array_key_first() и array_key_last() во всех трёх версиях или array_first() и array_last() в PHP 8.5. Используйте reset() и end(), когда последующий код читает текущую позицию через key() или current().

Частые вопросы

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

Используйте $array[] = $value. PHP назначит следующий числовой ключ. Если ранее из массива удаляли элементы, новый ключ может отличаться от текущего количества элементов.

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

Удалите элемент через unset($array[$key]), затем присвойте $array = array_values($array). Этот способ формирует список с ключами от нуля. Если известна позиция в списке, array_splice($array, $offset, 1) выполнит удаление и перенумерацию за один вызов.

Чем reset() и end() отличаются от array_first() и array_last()?

reset() и end() перемещают внутренний указатель массива и возвращают false для пустого массива. Функции array_first() и array_last() доступны с PHP 8.5, сохраняют позицию указателя и возвращают null для пустого массива.

Справка по теме

Ещё в разделе «Справочник PHP»

Как запустить PHP-файл: встроенный сервер, CLI и локальное окружение

Как создать и запустить PHP-файл из терминала или открыть его в браузере через localhost. Примеры для PHP 8.3–8.5, настройка сервера и разбор ошибок.

9 мин

Как узнать и обновить версию PHP: phpinfo, CLI и хостинг

Как узнать версию PHP через phpinfo(), CLI и панель хостинга, выбрать ветку PHP 8.3–8.5 и обновить сайт с проверкой расширений и совместимости.

8 мин

Как установить PHP на Windows, Linux и macOS

Как скачать и установить PHP 8.3–8.5 на Windows, Linux и macOS, настроить PATH и php.ini, подключить расширения и проверить работу PHP в терминале и браузере.

8 мин

Классы и ООП в PHP 8: свойства, конструктор, наследование

Как объявлять классы в PHP 8.3–8.5, типизировать свойства, писать конструкторы и наследовать классы. Примеры с self, static, parent и readonly.

9 мин