Массивы в PHP: создание, перебор и основные функции
Массив в PHP хранит значения под целочисленными и строковыми ключами. Один тип array подходит и для списка товаров, и для записи с именованными полями. Разберём, как читать и менять элементы, какие функции сохраняют ключи и что изменилось в PHP 8.3–8.5.
Тип array в PHP и создание массива
Массивы PHP устроены как упорядоченные отображения: каждому ключу соответствует одно значение, а элементы перебираются в порядке их расположения в массиве. Список обычно создают без явных ключей, ассоциативный массив — с парами ключ => значение. Оба имеют тип array. Значением может быть число, строка, объект, null или другой массив.
<?php
declare(strict_types=1);
$colors = ['красный', 'синий']; // Ключи 0 и 1
$user = ['id' => 42, 'name' => 'Анна'];
$users = [$user, ['id' => 43, 'name' => 'Иван']];
$colors[] = 'зелёный';
echo $users[1]['name']; // ИванПустой массив записывается как []. Для проверки, что ключи идут от 0 подряд и в том же порядке, используйте array_is_list(). Например, для [0 => 'a', 2 => 'b'] функция вернёт false, а для пустого массива — true.
В сигнатуре function total(array $prices): int PHP проверяет тип аргумента и результата, но тип array сам по себе допускает элементы любых типов. declare(strict_types=1) управляет строгой проверкой скалярных типов и не задаёт структуру массива. Для статического анализа документируйте контракт через PHPDoc, например list<int> или array{id: int, name: string}. Данные из формы или JSON проверяйте на входе.
Индекс массива PHP: ключи, чтение и удаление
Индекс списка — его целочисленный ключ. В ассоциативном массиве ключом может быть строка. В выражении $items[2] PHP ищет ключ 2, даже если элемент под ним стоит первым или последним. Присваивание по существующему ключу заменяет значение, а unset() удаляет элемент без перенумерации остальных.
<?php
$items = ['чай', 'кофе', 'вода'];
unset($items[1]);
$items[] = 'сок'; // Теперь ключи 0, 2, 3
$second = $items[1] ?? 'нет позиции'; // Ключ 1 отсутствует
$list = array_values($items); // Ключи 0, 1, 2При добавлении через [] индекс берётся из внутреннего счётчика, связанного с ранее использованными целочисленными ключами. Вычислять следующий ключ через count($items) рискованно: в примере элементов три, а ключ 3 уже занят. Если нужны позиции от нуля, сначала получите список через array_values().
Как PHP преобразует ключи
- Строка
'8'становится ключом8, а'08'остаётся строкой. Если сначала записать$map['8'], а затем$map[8], второе присваивание заменит первое. trueпревращается в1,false— в0, аnull— в пустую строку. Для внешних идентификаторов удобен явный префикс, например'id:' . $id.- Вещественный ключ приводится к целому, а потеря дробной части вызывает предупреждение об устаревшем поведении. Массивы и объекты в качестве ключей вызывают
TypeError.
Отсутствующий ключ и значение null
Прямое чтение отсутствующего ключа в PHP 8.x вызывает предупреждение Undefined array key. Оператор ?? и функция isset() считают отсутствующий ключ и значение null одинаково. Если null имеет собственный смысл, например поле явно очищено, проверяйте наличие через array_key_exists().
<?php
$settings = ['timeout' => null];
var_dump(isset($settings['timeout'])); // false
var_dump(array_key_exists('timeout', $settings)); // true
var_dump($settings['timeout'] ?? 30); // int(30)Перебор массива через foreach
foreach работает со списками, строковыми ключами и массивами с пропусками в индексах. Если нужен только элемент, используйте foreach ($items as $item). Чтобы изменить исходный массив, удобно перебрать пары и записать результат по ключу.
<?php
$prices = ['чай' => 120, 'кофе' => 180];
foreach ($prices as $name => $price) {
$prices[$name] = $price + 10;
}
print_r($prices); // Чай стоит 130, кофе — 190При переборе по ссылке, foreach ($prices as &$price), после цикла выполните unset($price). Иначе переменная останется ссылкой на последний элемент. Следующий цикл с той же переменной может незаметно изменить этот элемент. Цикл for с индексами от нуля подходит, когда array_is_list() возвращает true и в алгоритме нужна позиция.
Основные функции массивов PHP: поиск и преобразование
| Задача | Функция | Что учитывать |
|---|---|---|
| Посчитать элементы | count($items) | По умолчанию считает элементы верхнего уровня. Вложенный массив считается одним элементом. |
| Проверить наличие значения | in_array($value, $items, true) | true включает сравнение с учётом типа. |
| Найти ключ по значению | array_search($value, $items, true) | Возвращает первый подходящий ключ или false. Ключ 0 — успешный результат. |
| Получить ключи или значения | array_keys(), array_values() | Обе функции возвращают списки. |
| Изменить каждое значение | array_map() | При передаче одного массива ключи сохраняются. При передаче нескольких результат получает числовые индексы. |
| Оставить подходящие элементы | array_filter() | Сохраняет исходные ключи. Передавайте условие явно, если требуется сохранить 0 или '0'. |
| Свернуть массив в итог | array_reduce() | Укажите начальное значение, чтобы получить ожидаемый результат и для пустого массива. |
<?php
declare(strict_types=1);
$stock = ['чай' => 0, 'кофе' => 5, 'какао' => 3];
$available = array_filter($stock, static fn (int $qty): bool => $qty > 0);
$packs = array_map(static fn (int $qty): int => $qty * 2, $available);
$total = array_sum($packs); // 16
$key = array_search(0, [0, 5, 3], true);
if ($key !== false) {
echo $key; // 0
}Если отфильтрованный список отправляется в JSON, проверьте ключи. Например, результат array_filter([0, 5, 3]) сохраняет ключи 1 и 2, поэтому json_encode() выдаст объект. Для JSON-массива используйте json_encode(array_values($filtered), JSON_THROW_ON_ERROR).
Объединение и сортировка массивов
array_merge($a, $b)объединяет массивы, перенумеровывает целочисленные ключи и при совпадении строковых ключей берёт значение справа. Для соединения списков подойдёт и[...$a, ...$b]с тем же правилом обработки ключей.$a + $bсохраняет ключи и при любом совпадении оставляет значение слева. Подходит, чтобы дополнить пользовательские настройки значениями по умолчанию. Для двух списков с индексами от нуля часть элементов правого списка совпадёт по ключам и будет отброшена.array_replace($a, $b)сохраняет ключи, включая целочисленные, и берёт значение справа при совпадении. Вложенное значение заменяется целиком.
<?php
$defaults = ['limit' => 20, 'page' => 1];
$custom = ['limit' => 10];
$options = array_replace($defaults, $custom); // limit = 10, page = 1
$scores = ['Анна' => 9, 'Иван' => 6, 'Олег' => 8];
asort($scores, SORT_NUMERIC); // Иван, Олег, Анна. Имена остаются ключамиsort() и rsort() сортируют значения и перенумеровывают ключи. asort() и arsort() сохраняют связь ключей со значениями, а ksort() сортирует по ключам. Эти функции меняют переданный массив на месте: вызов $sorted = sort($items) запишет в $sorted значение true. Если нужен отдельный результат, сначала скопируйте массив, затем сортируйте копию. В компараторе usort() возвращайте отрицательное число, ноль или положительное число, например через <=>. Для своего компаратора с сохранением ключей используйте uasort().
Что изменилось в PHP 8.3–8.5
PHP 8.3: добавление после отрицательного ключа
Если в пустой массив явно записать элемент с отрицательным целочисленным ключом, следующее добавление через [] продолжит нумерацию с этого ключа плюс один. В PHP 8.2 и более ранних версиях в таком примере следующий ключ был бы 0.
<?php
$items = [];
$items[-5] = 'первый';
$items[] = 'второй';
print_r(array_keys($items)); // [-5, -4] в PHP 8.3 и новееPHP 8.4: поиск и проверка по условию
array_find() возвращает первое подходящее значение, array_find_key() — его ключ. array_any() проверяет, что условию удовлетворяет хотя бы один элемент, array_all() — что ему удовлетворяют все. Колбэк получает значение и ключ. Функции завершают перебор, как только результат определён. Для пустого массива array_any() вернёт false, а array_all() — true.
<?php
declare(strict_types=1);
$stock = ['чай' => 0, 'кофе' => 5];
$inStock = static fn (int $qty): bool => $qty > 0;
var_dump(array_find_key($stock, $inStock)); // «кофе»
var_dump(array_any($stock, $inStock)); // trueПри отсутствии совпадения обе функции поиска возвращают null. Если условию может соответствовать значение null, ищите ключ через array_find_key(), чтобы различать эти случаи. Для кода, который должен работать на PHP 8.3, используйте foreach с ранним выходом.
PHP 8.5: первое и последнее значения
array_first($items) и array_last($items) возвращают крайние значения в порядке массива без сдвига его внутреннего указателя. Обе функции возвращают null для пустого массива. Если null может быть самим значением, для проверки пустоты используйте $items === []. В PHP 8.3–8.4 получите ключ через array_key_first() или array_key_last(), проверьте его через !== null и прочитайте значение по ключу.
В PHP 8.5 передача null как аргумента ключа в array_key_exists() объявлена устаревшей. Если нужен ключ пустой строки, передавайте '' явно. Если null означает, что ключ неизвестен, обработайте этот случай до вызова функции.
Практический чек-лист
- Создавайте список через
[]и добавляйте элементы через$items[] = $value. Для записи с полями задавайте строковые ключи. - Обращайтесь по ключу. Для значения по умолчанию используйте
??, для проверки наличия поля с допустимымnull—array_key_exists(). - Перебирайте массив через
foreach. При поиске по значению включайте строгое сравнение, а результатarray_search()проверяйте через!== false. - После фильтрации, удаления или сортировки проверьте, какие ключи ждёт следующий участок кода. Применяйте
array_values(), если на выходе нужен список с непрерывными индексами. - Выбирайте способ объединения по двум признакам: чьё значение должно победить при совпадении и нужно ли сохранить числовые ключи. Перед использованием новых функций сверяйтесь с минимальной версией PHP проекта.
Частые вопросы
С какого индекса начинается массив в PHP?
В списке без явных ключей первый индекс равен 0. У массива с заданными ключами первым может быть любой целочисленный или строковый ключ.
Чем isset отличается от array_key_exists для массива?
isset возвращает false и для отсутствующего ключа, и для значения null. array_key_exists возвращает true, если ключ существует, независимо от его значения.
Как переиндексировать массив после array_filter?
Передайте результат фильтрации в array_values(). Функция сохранит порядок значений и присвоит им последовательные ключи, начиная с 0.