PHP in_array(): verificar se um valor está no array

in_array($needle, $haystack) retorna true se o valor está em algum lugar do array e false se não está. Passe true como terceiro argumento, in_array($needle, $haystack, true), para exigir também o mesmo tipo; essa forma estrita é a que deve ser usada por padrão.

<?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";
}

O in_array() só olha os valores. Para verificar se uma chave existe, use array_key_exists() ou isset().

O parâmetro strict

Sem o terceiro argumento, o in_array() compara com ==, que converte os tipos antes de comparar. Com true, ele compara com ===: o valor e o tipo precisam bater. A diferença aparece assim que o array mistura números e strings, o que é comum com dados de formulários, URLs e arquivos 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 célula abaixo é o que == e === retornam para aquele par de valores no PHP 8.3. O in_array() responde true se a agulha e algum elemento dão true na tabela do modo que você usa. Alterne entre as abas e olhe as linhas de null, true e das strings numéricas.

Uma regra mudou no PHP 8: uma string não numérica não é mais igual a 0, então in_array('abc', [0]) é false hoje, mas era true no PHP 7. Código escrito para PHP 7 às vezes dependia disso, o que é mais um motivo para passar true e não depender das regras de conversão. A página sobre operadores de comparação explica essas regras por completo.

in_array sem diferenciar maiúsculas

O in_array() compara strings com exatidão, então 'PHP' e 'php' são diferentes. Deixe a agulha e o array em minúsculas antes de verificar. O mb_strtolower() também lida com letras acentuadas e não 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));

Verificar vários valores de uma vez

O in_array() recebe uma agulha. Para várias, compare os arrays como conjuntos: array_diff() retorna as agulhas que faltam, então um resultado vazio significa que todas estão presentes, e array_intersect() retorna as agulhas encontradas.

<?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() comparam valores como strings, então ali 1 e '1' contam como iguais.

in_array num array multidimensional

O in_array() não busca dentro de arrays aninhados. Para verificar se alguma linha tem um campo com determinado valor, extraia esse campo antes com array_column() e depois busque na lista simples.

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

A última linha mostra que a agulha pode ser um array: ela bate com uma linha idêntica, com as mesmas chaves, valores e ordem.

in_array, array_search ou isset

Os três respondem "está lá?", mas retornam coisas diferentes e rodam em velocidades diferentes:

Use array_search() quando precisar saber onde o valor está. Quando você verifica muitos valores na mesma lista grande, inverta a lista uma vez para que os valores virem chaves, e use 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']));

Os tempos mudam a cada execução, mas a diferença não: a consulta com isset() fica estável, enquanto o in_array() cresce com o tamanho da lista. O array_flip() só funciona com valores string e inteiros, e duplicados viram uma única chave, o que não importa para verificar se um valor está presente.