Поиск в массиве PHP: in_array, array_search, array_filter
В PHP выбор функции зависит от результата, который нужен дальше: признака наличия, ключа первого совпадения или массива подходящих элементов. Разберём эти три операции и покажем, как сочетать их с преобразованием и объединением массивов.
Как выбрать функцию для поиска в массиве
Возьмём массив ['draft' => 'Черновик', 'live' => 'Опубликовано']. Чтобы узнать, есть ли в нём значение «Черновик», вызовите in_array(). Чтобы получить ключ 'draft' по этому значению, используйте array_search(). Если нужно проверить сам ключ 'draft', подойдёт array_key_exists(). Для отбора всех элементов по условию используйте array_filter().
| Задача | Функция | Результат |
|---|---|---|
| Проверить наличие значения | in_array() | bool |
| Найти ключ по значению | array_search() | Первый подходящий ключ или false |
| Проверить наличие ключа | array_key_exists() | bool, даже если значение по ключу равно null |
| Отобрать все совпадения | array_filter() | Массив с исходными ключами |
PHP in array: проверка наличия значения через in_array()
Порядок аргументов: in_array($needle, $haystack, true). Сначала передайте искомое значение, затем массив. Третий аргумент true включает строгое сравнение, при котором целое число 42 и строка '42' считаются разными значениями. Сравнение строк учитывает регистр. Функция просматривает значения верхнего уровня, поэтому для поиска внутри записей понадобится отдельное условие.
<?php
declare(strict_types=1);
$allowedIds = [0, 7, 42];
var_dump(in_array(42, $allowedIds, true)); // true
var_dump(in_array('42', $allowedIds, true)); // false: передана строка
var_dump(in_array('42', $allowedIds)); // true: нестрогое сравнениеdeclare(strict_types=1) и третий аргумент решают разные задачи. Директива включает строгий режим для скалярных объявлений типов при вызовах из файла. Способ сравнения значений внутри in_array() и array_search() задаёт их собственный параметр strict, который по умолчанию равен false.
Данные из формы часто приходят строками. Если приложение хранит ID как целые числа, сначала проверьте входное значение и приведите его к принятому типу, затем выполните строгий поиск. Простое приведение к int без проверки может превратить некорректную строку в 0 и дать совпадение с допустимым ID.
array_search(): как получить ключ первого совпадения
array_search($needle, $haystack, true) возвращает ключ первого совпадения в порядке обхода массива. Ключ может быть целым числом или строкой. При отсутствии совпадений функция возвращает false, поэтому проверяйте результат через !== false. Условие if ($key) пропустит корректный ключ 0.
<?php
$statuses = [0 => 'draft', 2 => 'live', 5 => 'draft'];
$key = array_search('draft', $statuses, true);
if ($key !== false) {
echo $key; // 0: первое совпадение, ключ 5 тоже содержит draft
}Если нужно проверить ключ или прочитать значение по нему
Для проверки существования ключа используйте array_key_exists(). Если значение null разрешено, эта функция отличит заданный ключ от отсутствующего. isset() возвращает false в обоих случаях.
<?php
$options = ['limit' => null];
var_dump(array_key_exists('limit', $options)); // true: ключ задан
var_dump(isset($options['limit'])); // false: значение nullArray filter в PHP: как отобрать все совпадения
array_filter() вызывает функцию обратного вызова для каждого элемента и оставляет элементы, для которых результат истинен. Возвращённый массив сохраняет ключи и порядок исходных элементов. Это удобно, когда ключи служат идентификаторами записей. Если ключи нужны только как позиции в списке, после отбора вызовите array_values().
<?php
declare(strict_types=1);
$statuses = [0 => 'draft', 2 => 'live', 5 => 'draft'];
$drafts = array_filter(
$statuses,
static fn (string $status): bool => $status === 'draft',
);
print_r(array_keys($drafts)); // [0, 5]: ключи всех совпадений
print_r(array_values($drafts)); // ['draft', 'draft']: список с индексами 0 и 1Пропуски в числовых ключах особенно заметны при формировании JSON. Например, PHP кодирует массив [0 => 'draft', 5 => 'draft'] как JSON-объект. Если контракт API требует JSON-массив, перед json_encode() восстановите последовательные индексы через array_values().
Отбор по ключу и значению
По умолчанию в функцию обратного вызова поступает значение. Режим ARRAY_FILTER_USE_KEY передаёт только ключ. Режим ARRAY_FILTER_USE_BOTH передаёт сначала значение, затем ключ. Например, можно выбрать активные настройки с общим префиксом:
<?php
$flags = ['beta_export' => true, 'beta_import' => false, 'audit' => true];
$activeBetaFlags = array_filter(
$flags,
static fn (bool $enabled, string $key): bool =>
$enabled && str_starts_with($key, 'beta_'),
ARRAY_FILTER_USE_BOTH,
);
print_r($activeBetaFlags); // ['beta_export' => true]Что удаляет array_filter() без условия
Вызов array_filter($values) удаляет значения, которые при приведении к bool дают false. В этот набор входят 0, 0.0, '0', пустая строка, false, null и пустой массив. Чтобы убрать только null из массива с разными типами, передайте условие static fn (mixed $value): bool => $value !== null. Тогда нулевая цена, выключенный флаг и пустая строка сохранятся.
PHP array_map: преобразование элементов перед поиском
array_map() преобразует каждый элемент. Например, из записей товаров можно извлечь артикулы и затем проверить наличие одного из них. При передаче одного массива array_map() сохраняет его ключи. При передаче нескольких массивов аргументы функции обратного вызова сопоставляются по позиции, а результат получает последовательные числовые индексы. Если длины входных массивов различаются, на недостающие позиции передаётся null.
<?php
$products = [
101 => ['sku' => 'A-10', 'active' => true],
205 => ['sku' => 'B-20', 'active' => false],
];
$skus = array_map(static fn (array $product): string => $product['sku'], $products);
var_dump(array_search('B-20', $skus, true)); // int(205): ID из исходного массива
$activeProducts = array_filter(
$products,
static fn (array $product): bool => $product['active'],
);
print_r(array_keys($activeProducts)); // [101]Если нужен только один товар по условию вроде «артикул совпадает и товар активен», достаточно foreach с досрочным выходом. Связка array_map() и поиска удобна, когда извлечённый массив нужен и дальше. Для множества поисков по одному полю можно заранее построить индекс по этому полю. Если значения повторяются, храните под каждым ключом список записей или явно определите, какая запись должна остаться.
PHP array_merge: объединение массивов перед поиском
array_merge() объединяет массивы. При совпадении строковых ключей побеждает значение из более позднего массива. Значения с числовыми ключами добавляются по порядку и получают новые индексы с нуля. Одинаковые значения при объединении сохраняются. Эти правила влияют на array_search(), если найденный ключ затем используется как ID записи.
<?php
$defaults = ['mode' => 'draft', 101 => 'A-10'];
$overrides = ['mode' => 'live', 205 => 'B-20'];
$merged = array_merge($defaults, $overrides);
var_dump($merged['mode']); // string(4) "live"
var_dump(array_search('B-20', $merged, true)); // int(1): новый индексЕсли нужно сохранить числовые ID и разрешить правому массиву перезаписывать значения по тем же ключам, используйте array_replace($defaults, $overrides). В примере поиск 'B-20' тогда вернёт 205. Если при совпадении ключей должны сохраняться значения левого массива, подойдёт оператор объединения +. Учитывайте способ хранения ключей: PHP преобразует строковый ключ '101' в целый 101, и array_merge() обработает его как числовой.
Что учитывать в PHP 8.3, 8.4 и 8.5
Описанные правила строгого поиска, возврата ключа и сохранения ключей при фильтрации одинаковы в PHP 8.3–8.5. Изменение нестрогих сравнений произошло в PHP 8.0: in_array(0, ['foo']) возвращает false. При этом числовые строки по-прежнему могут совпадать с числами: in_array(0, ['0']) возвращает true. Строгий режим одинаково различает типы во всех трёх версиях.
Начиная с PHP 8.4, доступны array_find_key() и array_find() для поиска первого элемента по произвольному условию. Первая возвращает ключ, вторая — значение. При отсутствии совпадения обе возвращают null. Если найденное значение само может быть null, используйте array_find_key(), чтобы отличить совпадение от его отсутствия. Для проверки, удовлетворяет ли условию хотя бы один элемент, с PHP 8.4 есть array_any(). Поиск прекращается на первом совпадении.
<?php
// PHP 8.4 и новее
$totals = [101 => 750, 205 => 1200, 309 => 1500];
$orderId = array_find_key(
$totals,
static fn (int $total): bool => $total >= 1000,
);
var_dump($orderId); // int(205): первый заказ на сумму от 1000Для кода, который должен работать и на PHP 8.3, ту же операцию можно выразить циклом с break:
<?php
$totals = [101 => 750, 205 => 1200, 309 => 1500];
$orderId = null;
foreach ($totals as $id => $total) {
if ($total >= 1000) {
$orderId = $id;
break; // Нашли первый заказ, дальше не ищем
}
}
var_dump($orderId); // int(205)Чек-лист перед использованием поиска
- Нужен ответ «есть ли значение» — начните с
in_array($value, $array, true). Приведите проверенные входные данные к типам, принятым в приложении. - Нужен ключ первого совпадения — вызовите
array_search()со строгим сравнением и проверьте результат через!== false. - Нужны все совпадения — используйте
array_filter()с явным условием. Для списка с индексами от нуля применитеarray_values(). - Нужно извлечь поле или преобразовать значения — используйте
array_map(). При объединении черезarray_merge()проверьте, нужны ли дальше исходные числовые ключи. - Для поиска по условию с досрочным выходом выберите
array_find_key()на PHP 8.4–8.5 илиforeachсbreakпри поддержке PHP 8.3.
Частые вопросы
Почему in_array() находит строку '42' в массиве целых чисел?
По умолчанию in_array() сравнивает значения нестрого. Передайте true третьим аргументом, чтобы при сравнении учитывался и тип значения.
Как отличить ключ 0 от отсутствия результата в array_search()?
Сохраните результат в переменную и проверьте её через !== false. При такой проверке ключ 0 считается найденным. Для отсутствующего значения функция возвращает false.
Как после array_filter() получить массив с индексами от нуля?
Вызовите array_values() для результата фильтрации. Если ключи служат идентификаторами записей, используйте результат array_filter() напрямую.