PHPTime

Ассоциативные и многомерные массивы в PHP

Массив в PHP хранит пары «ключ — значение» и сохраняет порядок элементов. Именованные ключи удобны для записей, а вложенные массивы позволяют хранить списки записей и данные с несколькими уровнями. Разберём доступ к этим данным, перебор, преобразование ключей и отличия PHP 8.3–8.5.

Ассоциативный массив в PHP

Ассоциативный массив обычно описывает запись с именованными полями. Например, у товара есть идентификатор, название и цена. PHP использует один тип array для списков и ассоциативных массивов. Ключи могут быть целыми числами или строками, а значения могут иметь разные типы. Элементы перебираются в порядке вставки.

PHP
$product = [
    'id' => 42,
    'name' => 'Чайник',
    'price' => 2490,
];

$product['price'] = 2290;       // Обновляем существующее поле.
$product['in_stock'] = true;    // Добавляем поле в конец массива.
unset($product['in_stock']);    // Удаляем поле.

echo $product['name'];          // Чайник

Присваивание по существующему ключу перезаписывает значение и сохраняет позицию элемента. При повторном объявлении ключа в литерале действует последнее значение. Удаление ключа через unset() сохраняет остальные ключи.

Как PHP преобразует ключи

Строка '42' становится целочисленным ключом 42. Строки '042' и '+42' остаются строками. Ключи true и false преобразуются в 1 и 0, а null при записи элемента становится пустой строкой. Дробное число преобразуется в целое с отбрасыванием дробной части. Если при неявном преобразовании теряется точность, PHP выдаёт уведомление об устаревшем поведении.

PHP
$labels = [
    '42' => 'первое значение',
    42 => 'последнее значение',
    '042' => 'отдельный ключ',
];

var_export(array_keys($labels)); // Ключи: 42 и '042'.

Если ключ приходит из внешних данных и его строковая форма важна, добавьте префикс, например 'sku:' . $sku. Это сохранит код товара строковым и защитит от совпадений с целочисленными ключами. Выражение declare(strict_types=1) правил преобразования ключей не меняет.

Чтение ключей: isset(), array_key_exists() и ??

Прямое чтение отсутствующего ключа, например $settings['theme'], в PHP 8.x выдаёт предупреждение Undefined array key. Для необязательного поля используйте ??. Если по правилам приложения нужно отличать пропущенное поле от поля со значением null, используйте array_key_exists().

PHP
$settings = ['theme' => null, 'notifications' => false];

var_dump(isset($settings['theme']));                 // false
var_dump(array_key_exists('theme', $settings));      // true
var_dump(array_key_exists('language', $settings));   // false

echo $settings['theme'] ?? 'system';                 // system
var_dump($settings['notifications'] ?? true);        // false
  • isset($array['key']) возвращает true для существующего значения, отличного от null. Значения false, 0 и пустая строка проходят эту проверку.
  • array_key_exists('key', $array) проверяет наличие ключа на текущем уровне массива, включая ключи со значением null.
  • $array['key'] ?? $default подставляет значение по умолчанию, когда ключ отсутствует или его значение равно null. Оператор ?: также заменил бы false, 0 и пустую строку.

В частичном обновлении записи эти различия влияют на результат. Если клиент пропустил поле, старое значение можно сохранить. Если он прислал null, это может означать явную очистку поля. Проверка через array_key_exists() позволяет обработать оба случая.

Многомерный массив в PHP

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

PHP
$orders = [
    [
        'id' => 101,
        'customer' => ['name' => 'Анна'],
        'items' => [['sku' => 'K-12', 'quantity' => 2]],
    ],
    [
        'id' => 102,
        'customer' => ['name' => 'Иван'],
        'items' => [],
    ],
];

$orders[0]['items'][0]['quantity'] = 3;
echo $orders[0]['customer']['name'];           // Анна
var_dump($orders[1]['items'][0]['sku'] ?? null); // null

Каждая пара квадратных скобок обращается к следующему уровню. Цепочка с ?? удобна для чтения необязательного пути. При разборе внешнего JSON или CSV отдельно проверяйте структуру. Например, вызов array_key_exists() для вложенного узла требует, чтобы этот узел был массивом. Для выбора значения у всех записей пригодится array_column().

PHP
$ids = array_column($orders, 'id');        // [101, 102]
$ordersById = array_column($orders, null, 'id');
echo $ordersById[102]['customer']['name'];  // Иван

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

Ключи и значения массива: array_keys() и array_values()

Для получения ключей массива в PHP вызовите array_keys(). Для получения значений отдельным списком вызовите array_values(). Обе функции работают с верхним уровнем и возвращают новые массивы с индексами от нуля. Порядок элементов соответствует порядку обхода исходного массива.

PHP
$stock = ['K-12' => 3, 'T-20' => 0, 'F-11' => 3];

$keys = array_keys($stock);             // ['K-12', 'T-20', 'F-11']
$values = array_values($stock);         // [3, 0, 3]
$matching = array_keys($stock, 3, true); // ['K-12', 'F-11']

Второй аргумент array_keys() ограничивает выборку ключами, у которых значение совпадает с заданным. Третий аргумент true включает строгое сравнение, чтобы число 3 не совпало со строкой '3'. Для проверки существования конкретного ключа достаточно вызвать array_key_exists() без построения списка ключей.

Когда нужно сбросить индексы

После фильтрации исходные ключи сохраняются. Если нужно передать клиенту JSON-массив, переиндексируйте результат. PHP кодирует массив с пропусками в числовых ключах как JSON-объект.

PHP
$quantities = [3, 0, 2];
$available = array_filter($quantities, static fn (int $quantity): bool => $quantity > 0);

echo json_encode($available, JSON_THROW_ON_ERROR);               // {"0":3,"2":2}
echo json_encode(array_values($available), JSON_THROW_ON_ERROR); // [3,2]

Функция array_is_list() проверяет форму массива. Она возвращает true, когда ключи идут от 0 подряд в порядке обхода, и для пустого массива. Применяйте array_values() там, где исходные ключи больше не нужны. В словаре товаров сброс ключей уберёт коды, по которым выполнялся поиск.

Перебор, изменение и строгая типизация

Цикл foreach ($array as $key => $value) даёт ключ и значение одновременно. Для обновления элементов удобно присваивать результат по ключу. Так код сохраняет идентификаторы и обходится без ссылок на элементы.

PHP
<?php

declare(strict_types=1);

/** @param array<string, int> $stock
 *  @return array<string, int>
 */
function reserveOneOfEach(array $stock): array
{
    foreach ($stock as $sku => $quantity) {
        if ($quantity > 0) {
            $stock[$sku] = $quantity - 1; // Сохраняем код товара как ключ.
        }
    }

    return $stock;
}

$remaining = reserveOneOfEach(['K-12' => 3, 'T-20' => 0]);
var_export($remaining); // ['K-12' => 2, 'T-20' => 0]

Нативный тип array проверяет тип аргумента целиком. Аннотация array<string, int> описывает типы ключей и значений для статического анализатора. Для записей с фиксированными полями можно указать форму array{id: int, name: string}, а для последовательности записей — list<array{id: int, name: string}>. Для внешних данных нужна проверка полей и их типов во время выполнения. Директива strict_types управляет строгой проверкой скалярных типов и не проверяет содержимое массива.

При обходе через foreach ($items as &$item) переменная $item остаётся ссылкой на последний элемент после цикла. Если затем использовать её для обычного присваивания или другого цикла, последний элемент может измениться. Завершайте такой обход вызовом unset($item).

Объединение массивов и типичные ошибки

Способ объединения зависит от смысла ключей. При конфликте строковых ключей array_merge() берёт значение из более позднего массива. Числовые ключи он перенумеровывает. Оператор + сохраняет ключи и при совпадении берёт значение слева. Функция array_replace() сохраняет ключи и при совпадении берёт более позднее значение.

PHP
$base = [10 => 'базовый', 'mode' => 'auto'];
$override = [10 => 'новый', 'mode' => 'manual'];

var_export(array_merge($base, $override));   // [0 => 'базовый', 'mode' => 'manual', 1 => 'новый']
var_export($base + $override);               // [10 => 'базовый', 'mode' => 'auto']
var_export(array_replace($base, $override)); // [10 => 'новый', 'mode' => 'manual']
  • Потеря идентификаторов. Если целочисленный ключ обозначает ID, используйте операцию, сохраняющую ключи. В примере array_merge() превращает ID 10 в позиции 0 и 1.
  • Обход разреженного массива через for. После unset() или фильтрации количество элементов не гарантирует существование ключей от 0 до count($array) - 1. Используйте foreach или явно переиндексируйте список.
  • Неожиданное удаление нулей. Вызов array_filter($array) без предиката удаляет значения, которые приводятся к false, включая 0 и '0'. Передайте явное условие, если ноль имеет смысл.
  • Замена вложенной записи целиком. array_replace() объединяет верхний уровень. Если нужно обновить только одно вложенное поле, укажите его путь явно и сохраните остальные поля.

Отличия массивов в PHP 8.3–8.5

Для общего кода на PHP 8.3–8.5 учитывайте минимальную версию проекта. Базовые операции с ключами и значениями доступны во всех трёх версиях. Различия затрагивают автоматический индекс, поиск по условию и получение крайних значений.

ВерсияИзменениеПрактическое применение
PHP 8.3Автоматический индекс может продолжаться от отрицательного ключа.После $items = [-5 => 'a']; $items[] = 'b'; новый элемент получает ключ -4. В более ранних версиях в этом примере он получил бы 0.
PHP 8.4Появились array_find(), array_find_key(), array_any() и array_all().Предикат получает значение и ключ. Поиск первого совпадения прекращает обход сразу после него. Для совместимости с PHP 8.3 используйте foreach с досрочным выходом.
PHP 8.5Появились array_first() и array_last().Функции возвращают первое и последнее значения в порядке обхода, а для пустого массива — null. Ключи крайних элементов доступны через array_key_first() и array_key_last() во всех трёх версиях.

Если null допустим как значение, результат array_find() сам по себе не позволяет отличить совпадение со значением null от отсутствия совпадений. Используйте array_find_key() и сравните возвращённый ключ с null через !==. Ключ 0 при этом останется корректным результатом поиска.

Практический чек-лист

  1. Выберите ключи по смыслу данных. Позиции подходят для списка, имена полей — для записи, идентификаторы — для поиска по словарю.
  2. Определите, что означает null. Используйте ?? для значения по умолчанию и array_key_exists(), если важно отличить пропуск от явного null.
  3. Проверьте форму входных данных перед чтением вложенных полей. Опишите ожидаемые ключи и типы в PHPDoc, если используете статический анализ.
  4. Получайте ключи через array_keys(), а значения — через array_values(). После фильтрации сбрасывайте индексы, если внешний контракт требует список.
  5. Перед объединением решите, какая сторона выигрывает при конфликте и нужно ли сохранить числовые ключи. Новые функции выбирайте с учётом минимальной версии PHP в проекте.

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

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

array_keys($array) возвращает список ключей, а array_values($array) — список значений. Если нужны пары ключ–значение, используйте foreach ($array as $key => $value).

Как безопасно прочитать значение из многомерного массива?

Для необязательного поля используйте $data['user']['name'] ?? 'Гость'. Если нужно различать отсутствующий ключ и значение null, сначала убедитесь, что вложенный узел является массивом, затем вызовите array_key_exists() для нужного ключа.

Почему после array_filter() PHP возвращает JSON-объект вместо массива?

array_filter() сохраняет исходные ключи. При пропусках в числовых индексах json_encode() кодирует результат как объект. Вызовите array_values() перед кодированием, чтобы получить список с индексами от нуля.

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

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

Вывод ошибок в PHP: display_errors, error_reporting и логи

Как включить вывод ошибок PHP через display_errors и ini_set, настроить error_reporting и error_log, найти логи и разобраться с deprecated в PHP 8.3–8.5.

9 мин

Дата и время в PHP: date, DateTime и часовые пояса

Как получить текущую дату и время в PHP, настроить часовой пояс, разобрать строку и отформатировать дату с date(), strtotime() и DateTimeImmutable.

8 мин

Загрузка файлов на сервер в PHP: $_FILES и безопасность

Как принять файл через $_FILES, проверить размер, MIME-тип и расширение, сохранить его вне публичной папки, выдать на скачивание и обработать ZIP.

10 мин

Интерфейсы, трейты и перечисления (enum) в PHP

Как применять interface, trait и enum в PHP 8.3–8.5: рабочие примеры, правила совместимости, разрешение конфликтов и разбор типичных ошибок.

9 мин