PHP in_array()：判断值是否在数组中

如果值在数组中的某个位置，in_array($needle, $haystack) 返回 true，否则返回 false。第三个参数传 true，即 in_array($needle, $haystack, true)，可以同时要求类型相同；默认就应该使用这种严格写法。

<?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() 只检查值。要检查某个键是否存在，请用 array_key_exists() 或 isset()。

strict 参数

不传第三个参数时，in_array() 使用 == 比较，会在比较前转换类型。传入 true 时，它使用 === 比较：值和类型都必须一致。只要数组中混有数字和字符串，区别就会显现出来，而来自表单、URL 和 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

下表中的每个单元格是 PHP 8.3 中这对值用 == 和 === 比较的结果。在你使用的模式下，只要要查找的值和任意一个元素在表中得到 true，in_array() 就返回 true。切换标签页，看看 null、true 和数字字符串那几行。

PHP 8 改变了一条规则：非数字字符串不再等于 0，所以 in_array('abc', [0]) 如今是 false，而在 PHP 7 中是 true。为 PHP 7 写的代码有时会依赖这一点，这也是应该传 true、不依赖类型转换规则的又一个理由。比较运算符页面对这些规则有完整的讲解。

不区分大小写的 in_array

in_array() 精确比较字符串，所以 'PHP' 和 'php' 是不同的。检查之前，先把要查找的值和数组都转成小写。mb_strtolower() 还能处理带重音的字母和非拉丁字母。

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

一次检查多个值

in_array() 只接收一个要查找的值。如果有多个，就把数组当作集合来比较：array_diff() 返回缺少的那些值，所以结果为空就表示全部存在；array_intersect() 返回找到的那些值。

<?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() 和 array_intersect() 按字符串比较值，所以在这里 1 和 '1' 被视为相等。

在多维数组中使用 in_array

in_array() 不会在嵌套数组内部搜索。要检查是否有某一行的某个字段等于给定值，先用 array_column() 把这个字段提取出来，再在这个一维列表中搜索。

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

最后一行说明要查找的值本身也可以是数组：它会匹配完全相同的一行，即键、值和顺序都相同。

in_array、array_search 和 isset 的区别

三者都能回答“它在不在里面？”，但返回的内容不同，运行速度也不同：

需要知道值在哪个位置时，用 array_search()。如果要拿许多值和同一个大列表比对，就先把列表翻转一次，让它的值变成键，然后用 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']));

每次运行的时间都会不同，但差距不会变：isset() 查找的耗时保持不变，而 in_array() 的耗时随列表大小增长。array_flip() 只适用于字符串和整数值，重复的值会合并成一个键，但这对判断是否存在没有影响。