PHP数组查找：in\_array与array\_search对比解析

在PHP中查找数组元素，`in_array()`和`array_search()`是两个常用的函数。本文将深入解析它们的用法和区别，助你高效地进行数组值查找。`in_array()`函数用于判断数组中是否存在指定的值，返回布尔值，适用于只需确认存在性的场景。而`array_search()`则更进一步，它不仅查找值是否存在，还会返回匹配值的键名（或索引），若未找到则返回false。选择哪个函数取决于你的需求：是仅仅想知道值“有没有”，还是想知道值“在哪里”。掌握这两个函数的特性和适用场景，能让你编写出更健壮、更高效的PHP代码，提升你的开发效率。

in_array()用于判断值是否存在并返回布尔值，array_search()则返回匹配值的键名，选择取决于是否需要获取位置信息。

在PHP中查找数组中的值，最常用且高效的两个内置函数是in_array()和array_search()。简单来说，in_array()用来判断某个值是否存在于数组中，返回一个布尔值；而array_search()则更进一步，它会返回匹配到的值的键名（或索引），如果没找到则返回false。选择哪个函数，完全取决于你想要达到的目的——是仅仅想知道“有没有”，还是想知道“在哪里”。

解决方案

PHP提供了两个核心函数来满足你在数组中查找值的需求。理解它们各自的特点和适用场景，能帮助你写出更健壮、更高效的代码。

1. in_array()：判断值是否存在

这个函数直观地回答了“数组里有没有这个东西？”的问题。

• 语法： in_array(mixed $needle, array $haystack, bool $strict = false): bool
• 参数说明：
  • $needle：你要查找的值。
  • $haystack：要搜索的数组。
  • $strict (可选)：一个布尔值。如果设置为 true，in_array() 会进行严格类型检查（即 === 比较），值和类型都必须匹配。默认是 false，只进行宽松比较（==）。
• 返回值： 如果在数组中找到了 $needle，返回 true；否则返回 false。

示例：

<?php
$fruits = ['apple', 'banana', 'orange', 'grape'];

// 查找 'banana'
if (in_array('banana', $fruits)) {
    echo "数组中包含香蕉。\n"; // 输出：数组中包含香蕉。
} else {
    echo "数组中不包含香蕉。\n";
}

// 查找 'kiwi'
if (in_array('kiwi', $fruits)) {
    echo "数组中包含猕猴桃。\n";
} else {
    echo "数组中不包含猕猴桃。\n"; // 输出：数组中不包含猕猴桃。
}

// 严格模式下的查找
$numbers = [1, '2', 3, '4'];
if (in_array('1', $numbers, true)) { // '1' (string) !== 1 (int)
    echo "严格模式下，找到了字符串 '1'。\n";
} else {
    echo "严格模式下，未找到字符串 '1'。\n"; // 输出：严格模式下，未找到字符串 '1'。
}

if (in_array(1, $numbers, true)) { // 1 (int) === 1 (int)
    echo "严格模式下，找到了整数 1。\n"; // 输出：严格模式下，找到了整数 1。
}
?>

我个人在用in_array()的时候，经常会忘记strict参数的重要性。尤其是在处理用户输入或者从数据库取出的数据时，类型可能会不经意间发生变化，导致非严格模式下的意外匹配。所以，如果对类型有明确要求，务必将strict设置为true，这能避免很多潜在的bug。

2. array_search()：查找值并返回其键名

当你不仅想知道值是否存在，还想知道它在数组中的具体位置（即键名或索引）时，array_search()就派上用场了。

• 语法： array_search(mixed $needle, array $haystack, bool $strict = false): int|string|false
• 参数说明：
  • $needle：你要查找的值。
  • $haystack：要搜索的数组。
  • $strict (可选)：与 in_array() 中的 strict 参数功能相同。
• 返回值： 如果在数组中找到了 $needle，返回其对应的键名（可以是整数索引或字符串键）。如果没找到，返回 false。

重要提示： array_search() 在找到第一个匹配项后就会停止并返回其键名。由于键名可能是 0（数组的第一个索引），而 0 在PHP的布尔上下文中会被视为 false，所以在检查返回值时，务必使用严格比较 !== false，而不是简单的 if ($key)。这是一个非常常见的PHP陷阱！

示例：

<?php
$users = [
    'admin_id' => 101,
    'editor_id' => 102,
    'viewer_id' => 103,
    'guest_id' => 104
];

// 查找值为 102 的键名
$key = array_search(102, $users);
if ($key !== false) { // 注意这里使用了 !== false
    echo "值为 102 的键名是：{$key}\n"; // 输出：值为 102 的键名是：editor_id
} else {
    echo "未找到值为 102 的元素。\n";
}

// 查找一个不存在的值
$notFoundKey = array_search(999, $users);
if ($notFoundKey !== false) {
    echo "值为 999 的键名是：{$notFoundKey}\n";
} else {
    echo "未找到值为 999 的元素。\n"; // 输出：未找到值为 999 的元素。
}

// 考虑索引为 0 的情况
$list = ['apple', 'banana', 'orange'];
$index = array_search('apple', $list);
if ($index !== false) {
    echo "苹果的索引是：{$index}\n"; // 输出：苹果的索引是：0
} else {
    echo "未找到苹果。\n";
}

// 错误示范：如果使用 if ($index) 可能会导致问题
if ($index) { // $index 是 0，会被视为 false
    echo "错误示范：通过 if ($index) 找到了苹果。\n";
} else {
    echo "错误示范：通过 if ($index) 认为没找到苹果。\n"; // 这行会被执行，因为 0 被当成了 false
}
?>

说实话，array_search()的=== false判断，是我给新手讲PHP时必强调的一个点。多少次，我看到同事的代码因为没有用严格比较，导致数组第一个元素被误判为不存在。这真的是一个需要刻在脑子里的细节。

什么时候应该用in_array()，什么时候用array_search()？

选择in_array()还是array_search()，关键在于你的“意图”和“需求”。它们虽然都是查找，但侧重点不同。

选择 in_array() 的场景：

• 只关心存在性： 当你仅仅需要知道某个值是否在数组中，而不需要知道它具体在哪个位置时，in_array()是最佳选择。
  • 例子： 检查用户是否拥有某个特定的权限（if (in_array('admin_permission', $userPermissions)) { ... }）。
  • 例子： 验证表单提交的选项是否在预定义的有效选项列表中。
• 代码语义清晰： in_array()的名称和返回值（布尔值）直接表达了“包含”的语义，让代码更易读懂。

文中关于php,数组,查找,in_array(),array_search()的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《PHP数组查找：in\_array与array\_search对比解析》文章吧，也可关注golang学习网公众号了解相关技术文章。