PHP in_array(): проверка наличия значения в массиве

in_array($needle, $haystack) возвращает true, если значение есть где-то в массиве, и false, если нет. Передайте true третьим аргументом, in_array($needle, $haystack, true), чтобы требовать ещё и совпадения типа; именно эту строгую форму стоит использовать по умолчанию.

<?php
$roles = ['admin', 'editor', 'viewer'];

var_dump(in_array('editor', $roles));
var_dump(in_array('owner', $roles));

if (in_array('admin', $roles, true)) {
    echo "Show the admin menu\n";
}

in_array() смотрит только на значения. Чтобы проверить, есть ли ключ, используйте array_key_exists() или isset().

Параметр strict

Без третьего аргумента in_array() сравнивает через ==, которое приводит типы перед сравнением. С true сравнение идёт через ===: должны совпасть и значение, и тип. Разница проявляется, как только в массиве смешаны числа и строки, а это обычное дело для данных из форм, URL и CSV-файлов.

<?php
$ids = [1, 2, 3];

var_dump(in_array('2', $ids));          // loose: "2" == 2
var_dump(in_array('2', $ids, true));    // strict: string is not int

$flags = [0, 'off'];
var_dump(in_array(null, $flags));       // null == 0
var_dump(in_array(null, $flags, true));

var_dump(in_array(true, ['yes']));      // 'yes' is truthy, so == true
var_dump(in_array('1e1', ['10']));      // both numeric: 10 == 10

Каждая ячейка ниже показывает, что возвращают == и === для этой пары значений в PHP 8.3. in_array() отвечает true, если игла и любой элемент дают true в таблице для выбранного режима. Переключайтесь между вкладками и смотрите на строки null, true и числовых строк.

В PHP 8 изменилось одно правило: нечисловая строка больше не равна 0, поэтому in_array('abc', [0]) сегодня даёт false, а в PHP 7 давало true. Код, написанный для PHP 7, иногда на это полагался, и это ещё одна причина передавать true, а не зависеть от правил приведения. Подробно они объяснены на странице об операторах сравнения.

in_array без учёта регистра

in_array() сравнивает строки точно, поэтому 'PHP' и 'php' разные. Приведите к нижнему регистру и иглу, и массив перед проверкой. mb_strtolower() справляется и с буквами с диакритикой и нелатинскими буквами.

<?php
$allowed = ['jpg', 'PNG', 'Gif'];
$ext = 'png';

var_dump(in_array($ext, $allowed, true));

$lower = array_map('strtolower', $allowed);
var_dump(in_array(strtolower($ext), $lower, true));

$cities = ['München', 'Zürich'];
var_dump(in_array('ZÜRICH', $cities, true));
var_dump(in_array(mb_strtolower('ZÜRICH'), array_map('mb_strtolower', $cities), true));

Проверка нескольких значений сразу

in_array() принимает одну иглу. Для нескольких сравнивайте массивы как множества: array_diff() возвращает недостающие иглы, поэтому пустой результат значит, что есть все, а array_intersect() возвращает найденные.

<?php
$skills = ['php', 'sql', 'git', 'docker'];

$required = ['php', 'git'];
$hasAll = array_diff($required, $skills) === [];
var_dump($hasAll);

$wanted = ['rust', 'sql'];
$hasAny = array_intersect($wanted, $skills) !== [];
var_dump($hasAny);

print_r(array_diff(['php', 'go'], $skills));   // what is missing

array_diff() и array_intersect() сравнивают значения как строки, поэтому 1 и '1' там считаются равными.

in_array в многомерном массиве

in_array() не ищет внутри вложенных массивов. Чтобы проверить, есть ли в какой-то строке поле с нужным значением, сначала извлеките это поле через array_column(), а потом ищите в плоском списке.

<?php
$users = [
    ['id' => 1, 'email' => 'ada@example.com'],
    ['id' => 2, 'email' => 'linus@example.com'],
];

var_dump(in_array('ada@example.com', $users, true));    // compares whole rows

$emails = array_column($users, 'email');
var_dump(in_array('ada@example.com', $emails, true));

var_dump(in_array(['id' => 2, 'email' => 'linus@example.com'], $users, true));

Последняя строка показывает, что игла сама может быть массивом: она совпадает со строкой, которая идентична ей, с теми же ключами, значениями и порядком.

in_array, array_search и isset

Все три отвечают на вопрос "есть ли?", но возвращают разное и работают с разной скоростью:

Используйте array_search(), когда нужно знать, где находится значение. Когда проверяете много значений по одному большому списку, один раз переверните список, чтобы его значения стали ключами, и используйте isset().

<?php
$banned = [];
for ($i = 0; $i < 100000; $i++) {
    $banned[] = "user$i";
}
$checks = ['user99999', 'guest', 'user5'];

$start = hrtime(true);
for ($n = 0; $n < 200; $n++) {
    foreach ($checks as $name) {
        in_array($name, $banned, true);
    }
}
printf("in_array: %.1f ms\n", (hrtime(true) - $start) / 1e6);

$set = array_flip($banned);        // values become keys, done once
$start = hrtime(true);
for ($n = 0; $n < 200; $n++) {
    foreach ($checks as $name) {
        isset($set[$name]);
    }
}
printf("isset:    %.1f ms\n", (hrtime(true) - $start) / 1e6);

var_dump(isset($set['user5']), isset($set['guest']));

Время меняется от запуска к запуску, а разрыв нет: поиск через isset() остаётся постоянным, а in_array() растёт вместе с размером списка. array_flip() работает только со строковыми и целочисленными значениями, а дубликаты схлопываются в один ключ, что для проверки наличия не важно.