Ассоциативные и многомерные массивы в PHP
Массив в PHP хранит пары «ключ — значение» и сохраняет порядок элементов. Именованные ключи удобны для записей, а вложенные массивы позволяют хранить списки записей и данные с несколькими уровнями. Разберём доступ к этим данным, перебор, преобразование ключей и отличия PHP 8.3–8.5.
Ассоциативный массив в PHP
Ассоциативный массив обычно описывает запись с именованными полями. Например, у товара есть идентификатор, название и цена. PHP использует один тип array для списков и ассоциативных массивов. Ключи могут быть целыми числами или строками, а значения могут иметь разные типы. Элементы перебираются в порядке вставки.
$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 выдаёт уведомление об устаревшем поведении.
$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().
$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); // falseisset($array['key'])возвращаетtrueдля существующего значения, отличного отnull. Значенияfalse,0и пустая строка проходят эту проверку.array_key_exists('key', $array)проверяет наличие ключа на текущем уровне массива, включая ключи со значениемnull.$array['key'] ?? $defaultподставляет значение по умолчанию, когда ключ отсутствует или его значение равноnull. Оператор?:также заменил быfalse,0и пустую строку.
В частичном обновлении записи эти различия влияют на результат. Если клиент пропустил поле, старое значение можно сохранить. Если он прислал null, это может означать явную очистку поля. Проверка через array_key_exists() позволяет обработать оба случая.
Многомерный массив в 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().
$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(). Обе функции работают с верхним уровнем и возвращают новые массивы с индексами от нуля. Порядок элементов соответствует порядку обхода исходного массива.
$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-объект.
$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
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() сохраняет ключи и при совпадении берёт более позднее значение.
$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()превращает ID10в позиции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 при этом останется корректным результатом поиска.
Практический чек-лист
- Выберите ключи по смыслу данных. Позиции подходят для списка, имена полей — для записи, идентификаторы — для поиска по словарю.
- Определите, что означает
null. Используйте??для значения по умолчанию иarray_key_exists(), если важно отличить пропуск от явногоnull. - Проверьте форму входных данных перед чтением вложенных полей. Опишите ожидаемые ключи и типы в PHPDoc, если используете статический анализ.
- Получайте ключи через
array_keys(), а значения — черезarray_values(). После фильтрации сбрасывайте индексы, если внешний контракт требует список. - Перед объединением решите, какая сторона выигрывает при конфликте и нужно ли сохранить числовые ключи. Новые функции выбирайте с учётом минимальной версии 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() перед кодированием, чтобы получить список с индексами от нуля.