PHP in_array(): prüfen, ob ein Wert im Array ist

in_array($needle, $haystack) liefert true, wenn der Wert irgendwo im Array steht, und sonst false. Übergib true als drittes Argument, in_array($needle, $haystack, true), um auch denselben Typ zu verlangen; diese strikte Form solltest du standardmäßig verwenden.

<?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() schaut nur auf Werte. Um zu prüfen, ob ein Schlüssel existiert, verwendest du array_key_exists() oder isset().

Der Parameter strict

Ohne drittes Argument vergleicht in_array() mit ==, das Typen vor dem Vergleich umwandelt. Mit true vergleicht es mit ===: Wert und Typ müssen beide übereinstimmen. Der Unterschied zeigt sich, sobald das Array Zahlen und Strings mischt, und das ist bei Daten aus Formularen, URLs und CSV-Dateien häufig.

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

Jede Zelle unten zeigt, was == und === in PHP 8.3 für dieses Wertepaar liefern. in_array() antwortet mit true, wenn der gesuchte Wert und irgendein Element in der Tabelle für den verwendeten Modus true ergeben. Wechsle zwischen den Tabs und schau dir die Zeilen für null, true und numerische Strings an.

Eine Regel hat sich in PHP 8 geändert: Ein nicht numerischer String ist nicht mehr gleich 0, also ist in_array('abc', [0]) heute false, war in PHP 7 aber true. Code für PHP 7 hat sich manchmal darauf verlassen, ein Grund mehr, true zu übergeben und nicht von den Umwandlungsregeln abzuhängen. Die Seite zu Vergleichsoperatoren erklärt sie vollständig.

in_array ohne Groß- und Kleinschreibung

in_array() vergleicht Strings exakt, also sind 'PHP' und 'php' verschieden. Wandle vor der Prüfung sowohl den gesuchten Wert als auch das Array in Kleinbuchstaben um. mb_strtolower() kommt auch mit Umlauten, Akzenten und nicht lateinischen Buchstaben zurecht.

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

Mehrere Werte auf einmal prüfen

in_array() nimmt einen gesuchten Wert. Für mehrere vergleichst du die Arrays als Mengen: array_diff() liefert die gesuchten Werte, die fehlen, ein leeres Ergebnis bedeutet also, dass alle vorhanden sind, und array_intersect() liefert die gefundenen.

<?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() und array_intersect() vergleichen Werte als Strings, also zählen 1 und '1' dort als gleich.

in_array bei einem mehrdimensionalen Array

in_array() sucht nicht in verschachtelten Arrays. Um zu prüfen, ob eine Zeile ein Feld mit einem bestimmten Wert hat, ziehst du dieses Feld zuerst mit array_column() heraus und durchsuchst dann die flache Liste.

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

Die letzte Zeile zeigt, dass der gesuchte Wert selbst ein Array sein kann: Er passt zu einer Zeile, die identisch ist, mit gleichen Schlüsseln, Werten und gleicher Reihenfolge.

in_array vs array_search vs isset

Alle drei beantworten die Frage „ist es da?“, liefern aber Unterschiedliches und laufen unterschiedlich schnell:

Verwende array_search(), wenn du wissen musst, wo der Wert steht. Wenn du viele Werte gegen dieselbe große Liste prüfst, drehst du die Liste einmal um, sodass ihre Werte zu Schlüsseln werden, und verwendest 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']));

Die Zeiten ändern sich von Durchlauf zu Durchlauf, der Abstand aber nicht: Der Lookup mit isset() bleibt flach, während in_array() mit der Größe der Liste wächst. array_flip() funktioniert nur mit String- und Ganzzahlwerten, und Duplikate fallen zu einem Schlüssel zusammen, was für eine Prüfung auf Enthaltensein keine Rolle spielt.