PHP in_array(): comprobar si un valor está en un array

in_array($needle, $haystack) devuelve true si el valor está en algún lugar del array y false si no. Pasa true como tercer argumento, in_array($needle, $haystack, true), para exigir también el mismo tipo; esa forma estricta es la que deberías usar por defecto.

<?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() solo mira los valores. Para comprobar si existe una clave, usa array_key_exists() o isset().

El parámetro strict

Sin el tercer argumento, in_array() compara con ==, que convierte los tipos antes de comparar. Con true, compara con ===: tienen que coincidir el valor y el tipo. La diferencia aparece en cuanto el array mezcla números y cadenas, algo habitual con datos de formularios, URLs y archivos 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

Cada celda de abajo es lo que devuelven == y === para esa pareja de valores en PHP 8.3. in_array() responde true si la aguja y cualquier elemento dan true en la tabla del modo que uses. Cambia entre las pestañas y mira las filas de null, true y las cadenas numéricas.

Una regla cambió en PHP 8: una cadena no numérica ya no es igual a 0, así que in_array('abc', [0]) hoy es false pero en PHP 7 era true. El código escrito para PHP 7 a veces dependía de eso, y es un motivo más para pasar true y no depender de las reglas de conversión. La página de operadores de comparación las explica por completo.

in_array sin distinguir mayúsculas y minúsculas

in_array() compara las cadenas exactamente, así que 'PHP' y 'php' son distintas. Pasa a minúsculas la aguja y el array antes de comprobar. mb_strtolower() también maneja letras con tilde y no latinas.

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

Comprobar varios valores a la vez

in_array() acepta una sola aguja. Para varias, compara los arrays como conjuntos: array_diff() devuelve las agujas que faltan, así que un resultado vacío significa que están todas, y array_intersect() devuelve las agujas que se encontraron.

<?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() y array_intersect() comparan los valores como cadenas, así que ahí 1 y '1' cuentan como iguales.

in_array en un array multidimensional

in_array() no busca dentro de arrays anidados. Para comprobar si alguna fila tiene un campo con un valor dado, extrae antes ese campo con array_column() y luego busca en la lista plana.

<?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 última línea muestra que la aguja puede ser también un array: coincide con una fila idéntica, con las mismas claves, valores y orden.

in_array vs array_search vs isset

Las tres responden "¿está ahí?", pero devuelven cosas distintas y tienen velocidades distintas:

Usa array_search() cuando necesites saber dónde está el valor. Cuando compruebes muchos valores contra la misma lista grande, invierte la lista una vez para que sus valores se conviertan en claves, y 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']));

Los tiempos cambian de una ejecución a otra, pero la diferencia no: la búsqueda con isset() se mantiene constante mientras que in_array() crece con el tamaño de la lista. array_flip() solo funciona con valores de tipo cadena y entero, y los duplicados se reducen a una clave, lo que no importa para comprobar si un valor pertenece a la lista.