in_array() w PHP: czy wartość jest w tablicy

in_array($needle, $haystack) zwraca true, jeśli wartość jest gdzieś w tablicy, i false, jeśli jej nie ma. Podaj true jako trzeci argument, in_array($needle, $haystack, true), aby wymagać także tego samego typu; tej ścisłej formy warto używać domyślnie.

<?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() patrzy tylko na wartości. Aby sprawdzić, czy istnieje klucz, użyj array_key_exists() albo isset().

Parametr strict

Bez trzeciego argumentu in_array() porównuje przez ==, które przed porównaniem konwertuje typy. Z true porównuje przez ===: muszą zgadzać się i wartość, i typ. Różnica wychodzi, gdy tylko tablica łączy liczby i stringi, co jest częste przy danych z formularzy, adresów URL i plików 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

Każda komórka poniżej to wynik == i === dla danej pary wartości w PHP 8.3. in_array() odpowiada true, jeśli igła i którykolwiek element dają true w tabeli dla używanego trybu. Przełączaj zakładki i spójrz na wiersze null, true i stringów liczbowych.

W PHP 8 zmieniła się jedna zasada: string nieliczbowy nie jest już równy 0, więc in_array('abc', [0]) daje dziś false, a w PHP 7 dawało true. Kod pisany pod PHP 7 czasem na tym polegał, co jest kolejnym powodem, by podawać true i nie zależeć od zasad konwersji. Opisuje je w całości strona o operatorach porównania.

in_array bez rozróżniania wielkości liter

in_array() porównuje stringi dokładnie, więc 'PHP' i 'php' się różnią. Przed sprawdzeniem zamień na małe litery i igłę, i tablicę. mb_strtolower() obsługuje też litery z akcentami i znaki spoza alfabetu łacińskiego.

<?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));

Sprawdzanie kilku wartości naraz

in_array() przyjmuje jedną igłę. Dla kilku porównaj tablice jak zbiory: array_diff() zwraca brakujące igły, więc pusty wynik oznacza, że są wszystkie, a array_intersect() zwraca igły, które znaleziono.

<?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() i array_intersect() porównują wartości jako stringi, więc 1 i '1' liczą się tam jako równe.

in_array na tablicy wielowymiarowej

in_array() nie szuka wewnątrz zagnieżdżonych tablic. Aby sprawdzić, czy któryś wiersz ma pole o danej wartości, najpierw wyciągnij to pole przez array_column(), a potem przeszukaj płaską listę.

<?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));

Ostatnia linia pokazuje, że igła sama może być tablicą: pasuje do wiersza identycznego, z tymi samymi kluczami, wartościami i kolejnością.

in_array vs array_search vs isset

Wszystkie trzy odpowiadają na pytanie „czy to tam jest?”, ale zwracają różne rzeczy i działają z różną szybkością:

Użyj array_search(), gdy musisz wiedzieć, gdzie jest wartość. Gdy sprawdzasz wiele wartości względem tej samej dużej listy, odwróć listę raz, aby jej wartości stały się kluczami, i użyj 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']));

Czasy zmieniają się między uruchomieniami, ale różnica nie: wyszukiwanie przez isset() pozostaje stałe, a in_array() rośnie z rozmiarem listy. array_flip() działa tylko dla wartości będących stringami i liczbami całkowitymi, a duplikaty łączą się w jeden klucz, co przy sprawdzaniu przynależności nie ma znaczenia.