PHP in_array() : vérifier si une valeur est dans un tableau

in_array($needle, $haystack) renvoie true si la valeur se trouve quelque part dans le tableau et false sinon. Passez true en troisième argument, in_array($needle, $haystack, true), pour exiger aussi le même type ; c'est cette forme stricte qu'il faut utiliser par défaut.

<?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() ne regarde que les valeurs. Pour vérifier si une clé existe, utilisez array_key_exists() ou isset().

Le paramètre strict

Sans le troisième argument, in_array() compare avec ==, qui convertit les types avant de comparer. Avec true, elle compare avec === : la valeur et le type doivent correspondre tous les deux. La différence apparaît dès que le tableau mélange nombres et chaînes, ce qui est courant avec des données venant de formulaires, d'URL ou de fichiers 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

Chaque case ci-dessous indique ce que == et === renvoient pour cette paire de valeurs en PHP 8.3. in_array() répond true si l'aiguille et un élément donnent true dans le tableau pour le mode utilisé. Basculez entre les onglets et regardez les lignes null, true et chaînes numériques.

Une règle a changé en PHP 8 : une chaîne non numérique n'est plus égale à 0, donc in_array('abc', [0]) vaut false aujourd'hui mais valait true en PHP 7. Du code écrit pour PHP 7 en dépendait parfois, raison de plus pour passer true et ne pas dépendre des règles de conversion. La page des opérateurs de comparaison les explique en détail.

in_array insensible à la casse

in_array() compare les chaînes exactement, donc 'PHP' et 'php' sont différentes. Mettez en minuscules l'aiguille et le tableau avant de vérifier. mb_strtolower() gère aussi les lettres accentuées et non latines.

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

Vérifier plusieurs valeurs à la fois

in_array() prend une seule aiguille. Pour plusieurs, comparez les tableaux comme des ensembles : array_diff() renvoie les aiguilles manquantes, donc un résultat vide signifie qu'elles sont toutes présentes, et array_intersect() renvoie les aiguilles trouvées.

<?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() et array_intersect() comparent les valeurs comme des chaînes, donc 1 et '1' y comptent comme égaux.

in_array sur un tableau multidimensionnel

in_array() ne cherche pas dans les tableaux imbriqués. Pour vérifier si une ligne a un champ avec une valeur donnée, extrayez d'abord ce champ avec array_column(), puis cherchez dans la liste à plat.

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

La dernière ligne montre que l'aiguille peut elle-même être un tableau : elle correspond à une ligne identique, mêmes clés, mêmes valeurs et même ordre.

in_array, array_search ou isset

Les trois répondent à « est-ce présent ? », mais renvoient des choses différentes et ne vont pas à la même vitesse :

Utilisez array_search() quand vous devez savoir où se trouve la valeur. Quand vous vérifiez beaucoup de valeurs dans la même grande liste, inversez la liste une fois pour que ses valeurs deviennent des clés, et utilisez 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']));

Les temps changent d'une exécution à l'autre, mais l'écart reste : la recherche avec isset() reste constante alors que in_array() grandit avec la taille de la liste. array_flip() ne fonctionne que pour des valeurs de type chaîne ou entier, et les doublons fusionnent en une seule clé, ce qui ne gêne pas pour un test d'appartenance.