PHP in_array(): verificare se un valore è in un array

in_array($needle, $haystack) restituisce true se il valore si trova da qualche parte nell'array e false altrimenti. Passa true come terzo argomento, in_array($needle, $haystack, true), per richiedere anche lo stesso tipo; quella forma stretta è quella da usare di default.

<?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() guarda solo i valori. Per verificare se una chiave esiste, usa array_key_exists() o isset().

Il parametro strict

Senza il terzo argomento, in_array() confronta con ==, che converte i tipi prima di confrontare. Con true, confronta con ===: valore e tipo devono corrispondere entrambi. La differenza emerge appena l'array mescola numeri e stringhe, cosa comune con i dati di form, URL e file 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

Ogni cella qui sotto è ciò che == e === restituiscono per quella coppia di valori in PHP 8.3. in_array() risponde true se l'ago e un qualsiasi elemento danno true nella tabella per la modalità che usi. Passa da una scheda all'altra e guarda le righe di null, true e delle stringhe numeriche.

Una regola è cambiata in PHP 8: una stringa non numerica non è più uguale a 0, quindi in_array('abc', [0]) oggi è false ma in PHP 7 era true. Il codice scritto per PHP 7 a volte ci faceva affidamento, un motivo in più per passare true e non dipendere dalle regole di conversione. La pagina sugli operatori di confronto le spiega per intero.

in_array senza distinzione tra maiuscole e minuscole

in_array() confronta le stringhe esattamente, quindi 'PHP' e 'php' sono diversi. Converti in minuscolo sia l'ago sia l'array prima del controllo. mb_strtolower() gestisce anche le lettere accentate e non latine.

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

Verificare più valori insieme

in_array() accetta un solo ago. Per più valori, confronta gli array come insiemi: array_diff() restituisce gli aghi mancanti, quindi un risultato vuoto significa che ci sono tutti, e array_intersect() restituisce gli aghi trovati.

<?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() e array_intersect() confrontano i valori come stringhe, quindi lì 1 e '1' contano come uguali.

in_array su un array multidimensionale

in_array() non cerca dentro gli array annidati. Per verificare se una riga ha un campo con un certo valore, estrai prima quel campo con array_column(), poi cerca nella lista piatta.

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

L'ultima riga mostra che l'ago può essere esso stesso un array: corrisponde a una riga identica, con le stesse chiavi, gli stessi valori e lo stesso ordine.

in_array vs array_search vs isset

Tutti e tre rispondono a "c'è?", ma restituiscono cose diverse e girano a velocità diverse:

Usa array_search() quando ti serve sapere dove si trova il valore. Quando confronti molti valori con la stessa lista grande, inverti la lista una volta così i suoi valori diventano chiavi, e usa 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']));

I tempi cambiano da un'esecuzione all'altra, ma il divario no: la ricerca con isset() resta costante mentre in_array() cresce con la dimensione della lista. array_flip() funziona solo con valori stringa e interi, e i duplicati si fondono in una chiave, cosa che non conta per un controllo di appartenenza.